

$5.85 US 
$6.95 Canada 
ISSN 106-8360 
Printed in U.SA 


32128 24882 


RABB'S APPLE 

isualiv Speaking 


PPLE TECHNOLOGY 

he OpcuDoc Development Framework 


For Macintosh Programmers & Developers 


111 This Issue! 


Intro To 


OpcnDoc 
kl)e\elopment 
A. Framework 


Inn 


A G 

11, No 11 • November 1995 


side: 


L ami Visual Architect, Part 2 


ic losing Bounds 

rMAMTEC TOP *> 


acApp Pascal Hides Again 




































































Building Internet And Other Native PowerPC 
Applications Has Never Been Easier Or Faster. 


SmalltalkAgents® 

SmaOlalkAgents (STA) is a 
sophisticated rapid applica¬ 
tion development environ¬ 
ment based on a new 

Ap tu> (Jifttl Vrtistit 

moiHtoiH errtrkin of the Smalltalk lan- 
enabling you to easily deliver double- 
dkkahle applkatioas, 

Copland Style GUI Look & Feel 
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design 3ml project derrxmrs in a “Rnder- 
lifce” desktop workspace as fluidly as vou 
work with folders aotj documents on your 
desktop. Interactively Ixiild, wire, and inter¬ 
connect reusable components and inter* 
fates in an integrated environment 

Gill Design & Generation 

live “Dragand Drop" manipulation to build 
your application's visual interface using 
components that "know" how to behave 
and autnn >n figure themselves into an envi¬ 
ronment. Create new components and/or 
wire together existing components that ran 
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lx? saved as reusable template designs for 
use in other applications or containers. 


Creating professional quality user interfaces 
is easy with nur cuiTijx merit parts libraries. 

VisualWorkbench 

Visually manipulate all objects including 
source and design dements using your 
mouse and keyboard. Visually manage 



DTP Engine & Word Processor 

5TA not only includes a pitigramniable 
whir] processor component and 
HypeiMedk engine, but also a powerful 
report writer that supjxirts embedding of 
any kind of objects, movies, flows, and 
international text; and page byouc 

C/C++, Pascal Workbench 

Compile, edit, and dynamically link OC+ +, 
Pascal, fortran, anti Assembly code directly 
from within chit STA VisiuiNuxkbendi as an 
integrated part < if the Smalltalk application 
development process. 

Component-based Architecture 

STA a imponcnts are designed for OpcnDoc 


and OIJB, and wall give you transparent inte¬ 
gration with OpenDoc and OLE when they 
become available. 

Threading & Internet Tools 

STA provides powerful support for Internet 



server as well as diem tool development. 
Pre-emptive threading, thread safe libraries 
and classes for TCP1P protocols are stan¬ 
dard features enabling you to quickly and 
easily deliver custom e-mail, WWW, list-serv¬ 
er, and other dial-up/network related apps. 


PowerPC Support 

STA provides binary portability across differ¬ 



ent CPI Is anti Operating Systems. Design 
applications today on one phdbnn and sinv 
ply deploy on other plathxms as required 

Contact us about our ttvb Server & 

Clkrnt IcKilkit at l-HOO-296-1339 or at 
<tnfo(o qks com> or visit our Web site 
hcp://wwwqkscom 

Quasar Knowledge Systems. Inc. 

9818 Parkwood Drive 
EJelhesda, MO 20814 USA 
TqC[ 301)53<M853 Fa*; [301 )530*571 2 



COunwif Knowledge Systems, Inc ty<K> AH nghis reserved Ail other brand nr product names are trademarks Of registered trademarks of their respective bolder 


































































































Eddy Award Winner for Best New Developer Tool 

Mnc (1st*r Fa /// ors Chnice A wards , / 99,1 

‘ A distinct improvement over ResEtlit." 

- Mactbch / MacTutor ^B 

"Resorcerer s data template system is amazing!” ^^B 

- Bill Goodman , auth or of Compact Fro ^^B 

'’Nuke Res Edit! Resorcerer is mission-critical for us* ” ^^B 

- Dave Winer ; Usertand Frontier ^^B 

"The color pixel editors a re wonderful! A work of art !* 

Dave Winzler , author of Microseeds Redux 

"Every Macintosh developer should own a copy of Re sorcerer ” 

- Leonard Rosenthal, Aladdin Systems 

“Resorcerer will pay for itself many limes over in saved time and effort* 

- MacUser review 

u The template that disassembles TICTs is awesome!” 

- Bill Steinberg, author of Pyro! and PBTbols 

"Resorcerer proved indispensible in its own creation!" 

- Doug McKenna, author of Resorcerer A 

m ...a wealth of timesaving tools. * 

Mac user Review, Dee. 1992 





Version 1.2.4 



* New i cien\ 4 ppat\ 4 crsr\ *acur% 4 pUt\ 4 clut’ editors 

* Powerful icon family editing (all 9 icon types! 

* Color pixel anti-aliasing, dithering, and lots more 


* New ‘cicn\ 4 ppat\ *crsr\ *acur\ 4 pltt\ 4 clut’ editors 

* Powerful icon family editing (all 9 icon types) 

* Color pixel anti-aliasing, dithering, and lots more 
■ Complete ‘PICT* disassembly and reassembly 

* Resource sorting; ROM resource browsing 

* 120 template field parsing types now supported 


Needs: £Mae Plus, £ Sys 4.2, 1MB 
Likes: ^Mac Plus, 5 Sys 7.0, 2MB 
32-bit clean, AU/X compatible 


New- L2 Features: * Resource sorting; ROM resource browsing 


* 120 template field parsing types now support* 

* New insertion & deletion template field types 

• Text-only ‘PICT* resources 

• Lots of improvements throughout 


Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 


Easier, fasten more Mac-like, and more productive than RcsEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and opens/marks/selects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Re z-1 ike scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 hits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pro- and post process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MncApp, QT, Help, AppleEvent, GCE, GX, etc. 
Full integrated support for editing color dialogs and menus 
Try out balloons, ictb’s, lists and pop ups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Well-designed, helpful developer tools being added all the time 
Relied on by thousands of Macintosh developers around the world 


Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 


Payment: Check, PCs, or Visa/MC 


Extras (call us); 

COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demos/Updaters: 

AppleLink: Software Sampler 
AOL: Software Libs/Devdopmcnt 
CompuServe; MACDEWTbols 
or call us. 


Try out balloons, "ictb’s, lists and 


popupj 
de Edi 


Mathem/estuetics, inc. 


P.O. Box 298 * Boulder * CO * 80306-0298 * IJRA 
Phone: (303) 440-0707 * Fax: (303) 4404)604 
AppleLink/AmericaOnline: RESORCERER • internet: rcsorcereiiSJaol.com 
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By Scott T Boyd, Hdilor-at Large 

http//www KaxconV 


Wdi, as uf this writing we still haven't heard anything of 
substance from Apple about the Mad lack Top Ten 
<http^/www.madiaictkconi/>. Sun:, they released a statement 
about the tup 5 items, but it was the same old -important future 
direction* verbiage we so often hear from Apple, From Apple’s 
initial response; 

"Stay tuned,..as we work out plans,./ 

"There’s a lot of support for this as an idea../ 

"We are investigating what would be involved.,." 

"Well consider validating it..." 

* We’re evaluating ./ 

"Any vohimeeisT 
“It s a goal*..* 

"A topic cif hot discussion..,*’ 

“...as that happens well have a letter vehicle-./ 

" Keep trac k i ng < >ur \m xlucl;innou ncements.,." 

{Thanks to At Hmms <at^fH»mtrtoob.com> for picking out 
the operative pbnaesj 

Funny, I didn't think much of the whole Top 10 DcvcIojkt 
Issues list idea at the conference, but Apple lias committed to 
address the issues, so 1 find their lack of action disappointing. 

It simply is not common practice for Apple to do market 
research on the needs and wants of Macintosh developers. 
Therefore, it shouldn’t lx* much of a surprise that Apple’s 
relationship with developers lacks a few items. 

It’s time for Apple to start delivering solutions to other 
problems tfuit have long plagued developers, let’s talk about a 
few constructive ideas. 

Information 

At twenty seven volumes and growing. Inside Macintosh is 
starting to represent a sign i brant investment for developers, hi 
terms of Ixrth lime and money. Even .so, developers could use* 
much more For example, as Sean Parent, Photoshop engineer 
and former Blue Meanie, recently said: 

"Apple, what 1 want Is a dear and precise explanation df 
every external puHn interface I want to knew what all the 
limitations, sale cflects, Ixigs, excqxional behavior, invariants, 
a\sumptitins, version history', ami supported jxtfunxler ranges 
are. IiiskIc Mac givts me aUxii 10% of that/ 

Once we liave a good start on that, publishing die* information nrs 
the Internet and on cheap CDs would make a great next step. 


O vercc »m i n g H mitat ions 

TextEdit, the Menu Manager, tlx* Dialog Manager, and the 
List Manager have long represented Apple's strange affinity tor 
living with arbitrary limitations They have all evolved just 
about as far as they can. Mayl>e it's lime to offer up some new, 
improved ttxtfbox managers. While it runs the risk of dying of 
not-jnvented-taere syndrome, would it be that tar-fetched For 
Apple lo license some third-party solutions? 

For example, imagine the benefit to developers should 
Apple decide to do away with the 42K TextEdit limit by taking 
Chris Thomas recent suggestion on Semper.Fi, "Just put WASTE 
in a shared library, license it for inclusion with System 7,6 and 
lieyond, and lx done with it/ Well, w rite some does and test it 
a hit, too. 

Bringing Apple applications Into the 90’s 

Where do we sun on this one? OpenDoc support in the 
finder and MFW? AppleScript support for Apple control panels, 
SimpleTcxi, MFW, and others? 

Attention 

Developers need Apple’s attention, Apple needs 
developers' attention. It all comes down to rebuilding the 
relationship between Apple and developers, but we ll save 
some of this for later. Don't forget to cheek out the web site for 
further developments, which Apple has promised by the 
Ivgtnning of October. 

Pktihf^ If You Will..* 

Karely does Apple put out advertising tlrat we can all lx j proud 
of Sure, there futve lieen ads that made us feel good but deep 
down wc usually know that the ads are preaching to the choir. 
What was the last time we saw an advertising campaign that 
we all just knew sold ocxllcs of machines? 1 don’t even know it 
the -great’’ 1984 commercial sold many machines. 

To lx* fair. Apple used to futve some good ads which 
managed to deliver the “wow!” factor t rvcenrly thought that 
they’< I made a comeback, but l was rudely surprised to find out 
that they were actually Compaq ads, I was shocked. 

However, it's all tlx rage to drive $10B companii^ from tlx* 
back seal bildy, so bat* goes. If I was in charge, I d probably try 
a few wacky tilings l ira ad campaign? Show developers writing 
software on the Macintosh. Vfc don't need nuns with pagers or 
corporate execs with surllxards, we’ve got real program mers 
putting logedxT niajor-teague products using Macintosh. 

Continued on page 68 
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Each year, the illegal use of software 
consumes nearly 50% of your |N>teuiial 
revenues. Willi tlie Haines of |)iracy eating 
away at your profits, can you afford not to 
protect yiHir software? 


Software Obtained Illegally, by region. 1993 vs. '994 
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Mad IASI* * is widely acclaimed as the world s 
most advanced software protection solution 
for Macintosh computers. Since 19H4. 
thousands of leading Mac and IT, develqiers 
have used over one million MacilASP and 
HASP keys to protect billions of dollars worth 
of software. Why? Because MadlASP’s 
security, reliability, and ease-of-use led them 
to a simple conclusion: MacilASP is the most 
effective software protection system available. 



Today, more developers are choosing 
MacilASP than any other software protection 
method To learn why. and to see how easily 
you cm increase your revenues, call now to 
order your MacilASP Developer's Kit. 

1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 

Nortli Aladdin Software Security Inc 

America Trf; mn Zl$ 212 

fix. 212-S64 5377 
F mail. sak^lia^cnrn 

linp//wi»'w fiwocuii/ 

inti Office Aladdm Knowledge Systems Ltd. 

Id hot 97 1-IW v"* 

F-infill .il.iihlmw aJfiddm.co il 

United Aladdin Knowledge 

Kingrium Systems UK Lid. 

T H 017534122ft, ha 01735422262 

France Aladdin France SA 
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I ts the highly-regarded industry 
standard, used by motr developers 
than any other Macintosh develop¬ 
ment system. And now its been 
totally re-engineered for I\jwer Mac. 

Introducing Symantec C++* 8.0 
for native Power Mac, 

Not since the original THINK 
C/" has anything so dramatically 
Insisted your productivity. There's a 
Visual Architect™ to generate GUI 
code instantly. An advanced Project 
Manager to handle the largest and 
most complex jobs. Plus native 
Power Mac tools for radically 


The Industry Standard Just Moved To A Higher Power. 
Symantec C++ 8.0 For power Mac. 



improved performance* 

Draw on the 
Industry Standard. 

With Symantec C+ * 8.0, you sim¬ 
ply draw the user interface - including 
windows, dialogs, controls, icons and 
menus. Then the built-in Visual 
Architect generates the axle with the 
dick of a mouse. Now you can spend 
more lime on what really sets your 
application apart its functionality. 

A Higher Standard 
For Speed. 

Ilie new high-performance com¬ 
piler is dramatically faster than rhe 
previous version, so you can become 
more productive than ever. 

And for even more power, weW 
added an Advanced ftojcci Mu toga. It 


gives yim drag ami drop so you can eas¬ 
ily odd tiles. Named Opr ion Sets for 
dunging axnplac sets of options Hist, plus 
support for even the largist applications. 

The res also a new editor and a 
browser for modifying ,md navigating 
source files, a new debugger, an 

Newt Fast C 

And C++ Compilers 

for }mb Mac and Pouter Mat 

New Visual Akci wrier 

for the Power Mar 

New Think Cuss Library 

2.0 for /burr Mat 

New Popup Menus 

take you right to dccLtrrftutm & treaden 

New Debugger 

for messed projects and shared libraries 

New Project Manager 

for multiple targets and 
hierarchical support 

New Split Pane Editor 

for rpitax highlighting and 
auto formatting 


SYMANTEC. 


incremental linker, THINK Class 
library™ 2.0 and much more. 

A Double Standard For 
68k And Power Mac. 

Symantec C++ 8,0 is the first 
native Mac/Powcr Mac development 
system to support C++ templates, 
nested classes and multiple inheri¬ 
tance, as well as ANSI C. Hus 8,0 
includes version 7.0 for 68 K support. 

This double standard gives you 
everything you need for both 68K 
and Power Mac development. 


verier 4 / 4 tpmal upgrade price of 
| fuM t tttX} &2H 47771*1 9tt2t. | 8 

He wr t* 41 k dma the fyrtmnift | 

t'iet'fiopert Advantage }*rogrjm 
for pwtttum tuppart jW fflfti -{ 

Lit update* Or trim ymer beat C++ 

wfiuwtr there. 
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GETTING 

STARTED 


By Daw Mark, MacTech Magazine Regular Contributing Author 



TCL and Visual Architect, Part 2 


In last month’s column* * we took a look 
at $ y nun lee's latest development 
environment, including the Symantec 
Project Manager ami Visual Architect. 
Following the example presented in 
Chapter 14 of the Symantec 0+ User's 
Guide, we used Visual Architect to 
generate source code to implement the 
single, default view named Main, We 
then returned 10 the .Symantec Project 
Manager and compiled the code into a 
standalone application (See Figure 1)* 




" 

1 

: 1 ... • ■ ■" . -• ■■■■ . ~ ills 



Figure I The window that Appeared 
when ue ran last month’s program. 


This month, we’re going to add a 
second view' to our program. This 
second view will )ie a dialog that allows 
you to type a number into an editable 
text held. When you press the Beep 
button, the dialog will beep the 
specified numlxr of times. 


appears* double dick on the file name Visual Architect.rsrc to 
bring up Visual Architect. This is where well add the second 
view* 

■ Select Neiu LMetu from the Uieiu menu* 

• When asked to name the new view, type BeeperDialog 
and make sure Modal Dialog is selected from the Uieiu 
Kind: popup menu [Figure 2), then press the OK button. 


Please name the neiu uieiu 


Name: 


BeeperOialog 


Uietu Kind: [ Modal Dialog ^ | 

[ Cancel | | = 0K_J 


Figure 2\ Naming the new view . 

The name BeeperOialog will Ik? used as die basis for a new 
class, called GEeeper Dialog. The next time you select 
Generate from Visual Architect's Symantec Project Manager 
menu, Visual Architect will generate the files ClteeperDialog.cp, 
CBeeperl )lalog*h, x^CBceperl )ialog*cp, and \_CBeeperDialog.h* 
Firsi, we’ll add a few items to this dialog and then add a button 
to our Main view that brings up the dialog. 

Once you press rhe OK button, a view window will appear 
with the name BeeperOialog 

* Select Diem Info from the Uieui menu. 


Adding a Second View 

Go into the Button / folder you created 
last month and double-dick oft the file 
lkitton.it to launch the Symantec Project 
Manager When the project window 


A view info window tilled Dialog Info will appear 
( Figure 3)- The view info window, which looks a lot like a 
ResBdit or Kesorcerer WIND templai, lets you customize the 
look of your new' dialog window* 
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Figure ,J. The view info uindowfor the BeeperlMatog view. 


text lal>el p ami an editable text field for entering the number of 
heeptc Well .start with the DK and Cancel buttons. 

• Click on the button tool in the palette window. 

* Click on the BeeperDialog window' and drag out an OK 
button. 

As you drug, keep your eye on the lower left comer of the 
window, Notice that the two coordinates listed reflect the 
upper left and lower right comers of the button. 1 made my 
billion 80 pixels wide and 20 pixels tall with an upper left 
comer of (200,42). 


• Click on the movable mixial dialog icon (the second from 
the right) or type in the proclD: field. 

• Click on the OK button to dismiss the dialog. 

Your next step is to add some items to the dialog. 

• Click on the Tools menu and drag down until the tool 
palette outline apficaix 

When you release the mouse button, the Tools palette 
window wilt appear (Figure 4). Take a few minutes to play 
with the items in this palette. In the lop row', you have the 
selection tod, the text tool, and the editable tcxL tool. 'Hie 
second row features the pushbutton tool* the radio button 
tool, and the check box tool. The third row features the 
popup menu, Icon* and PICT tools. Well get into the rest of 
the tools in a future column. For now* try creating items 
based on the tools in the first three rows. Click on a tool, 
then click and drag in the BeeperDialog view window. Once 
you get a feel for these tools, select the .selection tool (the 
arrow), then click on each of the items yon added and press 
the delete key. Keep on deleting until the BeeperDialog 
window is empty again. 
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Ftytt re 4 . The 7 ools palette. 

Now let s add the items that make up I lie Beeper dialog. 
Well add four items; an OK button, a Cancel button, a static 


* Click on the BeeperDialog window and drag out a Cancel 
button. 

My Cancel button was also 80 pixels wide and 20 pixels 
tall. 'Ibis lime, the upper left comer was (107,42). Notice that 
VA automatically filled in the text OK for the first button and 
Cancel for the second button. Nice feature! Let 1 s change the 

OK ro say Beep 

* Double-click on the OK button (or dick on it and select 
Pane Info.., from the Pane menu) to firing up the Pane 
Info window. 

* Click on the triangle to the left of the class name 
[Control revealing the CControl data members, 

* Change contrlTiile from OK to Beep anil dose the Fane 
Info window. 

Notice that the button s name changed from OK to Beep 
Now let's add the static text label, 

* Click on the static lexl tool (the big letter M in the palette 

window, 

* Click in the BeeperDialog window and type the text 
Number of times to beep: 

* Click outside the static text to slop entering text, then dick 
on tiie static text to select it. Drag it to a satisfactory 
position in the BeeperDialog window, 

! dragged my static text so its upper-left corner was ul 
(23 t 13). You might warn 10 use the arrow keys to move the 
static text around the window, 4 pixels at a time. Hold down 
the command ($ 8 ) key to get the arrow keys to move 1 pixel at 
a time. Experiment with the Shift and option keys which let 
you resize an item by 1 or i pixels in any of i directions 

Finally* let s add an editable text field. 

* Click on the editable text tool (to the right of the static text 
tool) in the palette window, 

* Click on the BeeperDialog w indow anil drag out an editable 
text area. 
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Mine had and upper left comer of (205,13) and a lower 
right of (280,29). Once your items are in place, resize the 
dialog view so it comfortably encloses the dialog items. To do 
that, dick on the handle in die lower-right comer of the grey 
rectangle embedded in the BceperOialqg window. Drag the 
handle to its new position. I dragged mine to (293,75). The 
finished Beeper dialog is shewn in Figure 5. 



Figure 5. The finished Beejxr dialog with the Beep button 
selected. 


If you like, you can try the dialog out by selecting Try 
Out from the Hie tu menu. Click on one of the buttons or 
select Close from the File menu to close the Try' Out window 
once you are done admiring your handiwork. 

Our next task is to tell VA that our ediMexi Field is 
designed to hold only integers (as opfjosed to any old text). 

* Click on the editable text field. 

* Select Ctass from the Pane menu, then select 
ClntegerText from the submenu that appears. 

Next, we need to define a new command that will get sent 
when the Beep button is clicked. Right now the Beep 
button’s command is set to cmdOK. To see that, double-click 
on the Beep button to bring up the Pane Info window, then 
click on the C But ton triangle. Take a kxik at the Command 
popup menu. If you click on it, you'll find a whole bunch of 
commands, all of them built into the TGI. Since there is no 
Beep command, well need lo define it ourselves, ihcn set the 
Beep button to send it when clicked. 

* Close I he Beep Pane into window, if you opened it to kx>k 
at the Command popup. 

* With the BeeperDialog window front most, select 
Commands,,, from the Edit menu. 

* When the Commands window appears, select Netn 
Command from the Edit menu. 

* Type cmdBeep in the uppermost editable text field. 

* .Selec t CBeeperOtaloy from the In Class: popup menu. 
This tells VA which class this command belongs to. 

* Select Call from the Bn: popup menu. 


This tells VA what you want done in response to tins 
command. You could do nothing, you could ask VA to call a 
function, or you could open another view. In our case, we’ve 
asked VA lo call a ClkepcrDiakjg tneml x_t function. Well get 
to that function in a bit. 

Notice that VA automatically generated the command 
numiier 512, This is not particularly important. You’ll use the 
constant ctndBeep instead of 512 T so there’s no reason to 
memorize your command numbers. 

* Click on the OK button to dismiss Lite Commands dialog. 

As you've probably guessed, your next step is to associate 
the cmdBeep command with the Beep button. 

* Double click on the Beep button to bring up the Banc Info 
window. 

* Click on the triangle to the left of the class CRu t ton 
revealing the Command popup menu. 

* Select cmdBeep from the Command popup (Figure 6), 

* Close the Pane Info window. 



Figure 6. The Pane Info window associated with the Beep 
hutlmi Notice that the (Jam maud popup 
has been set to cmdlieep. 

You may have noticed that the Beep button no longer has 
the bold, rounded rectangle around it, specifying it as the 
default button, the button pressed when the user hits return. 
This changed Invausc VA specifics the cmdOK command as the 
default. Let's fix that. 

■ Select Set Default Command from ihc Llieui menu. 

• Select cmdBeep from the Command popup menu, then 
press OK 

Notice that the bold, rounded rectangle is back around the 
Beep button (Figure 7X 
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MICROGUARD?# 

Why so many developers are switching to 
MicroGuard copy protection 


MicroGuard is committed to uncompromising 
technological superiority 
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bmught vuu MicroGuard Ptu$ m . And, MicroGuard Plus b 100% 
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MicroGuard offers you the 
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protection 
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MicroGuard is the only key 
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since 19H i Wc art* not a PC prutartitm company dial \m come to you 
with a Mac (mxlun MJrroCitofri is fully ADB sawy and offers emended 
add Rising. Unlike ultcr pnxcctkm devices, MicroGuard never dashes 
with other keys Only MkroGuaid offers this level of sophistication. 


MicroGuard has now surpassed its own 
technological lead, actually improving on the best 

MirroGuarii Plus ls everything MicroGuard ls, {ihcs 40-hit encryption, two 
additional passwords. 64-liit Array, J24iyiu public area, 45% she reduawin, 
enhanced counter and more. In addition, MuroGuajd Hus offers two new 
Utilities QuickC turd m ami tasyGuard" 1 allow you to protect your 

appSotkira without touching \vur 
sourer rocie The only feature that 
k no* phis b the price. -) 


MicroGuard is the best 
selling Macintosh key in 
the world 

M ten Guard sells more Macintosh 
mpyf frfleninn keys than anyone else 
m the mkl! 


• MicroGuard delivers 
developer support 
within 24 hours 

We will answer any inquire you have within 2l-hours Wc also have a fully loaded 
AppkiJink bulletin hoard which contains all our libraries, tab notes, Q&Aarni 
nearly everything you’ll ever nrrdl 
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Figure 7. The BeeperOialog window, 
once cmdBeep is set as the default command. 


We are almost dune! Now we have to add a button to the 

Main view that brings up the Beeper dialog. 

* Close the BeeperOialog view window. 

* Double-click on Main in the view list window to firing up 
the Main view window. 

* Click on the grow box in the lower left corner of the Main 
view window and drag dow n about 50 pixels. 

* Click on the handle in the lower right comer of die grey 
bounding rectangle Inside the window and drag it down 
about SO pixels. 

You've just resized the Main view to \k altftul SO pixels 

taller, making nx>m lor a new pushbutton. 

■ Click on the pushbutton tool (under the arrow) in the 
palette window. 

* Click in the Main view window and drag out a new' button 
below the PICT. 

■ Before you click off the button, type the word Beeper... 
The button will now 1 >ear the name Beeper..,. 

* Double-click on the Beeper,.* button, bringing up the 
button's Pane Info window. 

■ Click on the triangle next to the class name CButton to 
reveal the CButton data members. 

* Choose Other**, from the top of the Command popup 
menu. 

■ When the Commands dialog appears, choose New 
Command from the Edit menu, 

* Enter the command name cindfieeperflialtig 

* Choose CMain Imm the In Class: popup menu to let VA 
know you want the new command associated with the 
CMain class, 

■ Choose Open from the Do: popup menu. 

* Choose CBeeperOialog from die Uiew: popup menu. 

We've just told VA that we want this new command 

(cmdBceperDialog) to open the CBeepcrDialog view (See 

Figure 8 ). 



Figure The Ct mmands window for the new 

cmdiieeperOiahg command. 


* Click on the OK button. 

Now we've told VA to associate this command with the 
Beeper*** button we just created. 


■ Close the button's Pane Info window to return to the Main 
view window' (Figure 9). 



Figure 9. My Mam tiew with my new Beeper*** button 


If you like, select Try Out from the Uieiu menu and take 
your new version of Main for a spin. Note that we haven't put 
the code in place that gets called when the Beeper,,, button 
is pressed* but the scrollbars should work and the button 
should highlight when clicked. 

Our next step is to ask VA to regenerate our source code, 
reflecting the new panes and commands we've defined. 

* Select Generate.,, from the Symantec Project Manager 
menu (diamond shaped menu to the right of the 

LllincJoiiJS menu). 
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* When prompted to save your changes, dick OK 

VA will update your existing axle base, tf you selected 
Generate flit..*, VA would have replaced your existing 
code base. Be sure you understand this difference! 

Adding the New' Code 

Our Iasi step is to add a Few lines of axle to bring all our new 
interface elements together 

* Return to the Symantec Project Manager. 

* In the project window, dick on the triangle to the left of the 
folder labeled Source Skip this step if the Source folder 
was already opened, 

* Double click on the file name XBceperDialog.ep". 

* Add this axle to the end of Clk-eperDialogxp; 

void CtteeperP I«I og:: ItoCwtBeep () 
long ri: 

ri ” f HeeperQlalOjC-iMitJS->GetTdSValue(J : 
for t long 1HJ: l<n; IH J 
SysBeepi 20 ): 


This code references the data member 
fBeeperl )ialog_ Edit It When VA generates your code, it makes 
up a coastani for each of your dialog items. You can find these 
definitions in the File BeeperUialogltcnts.h. Here's the 
constants that were generated for my version of Beeper: 

tinum 

I 

BeeperDinln^ ftpglru, 
kBeeperOI jdr*g_rtutnU * U 
kB(*rportVlulDg_ButnI2II> * 2G49L* 
kRccpermuloB-ButtilJ * 2, 
kfk’upe r tti a 1 o je_Butn 1 MB - 70SOL. 
ktteeperIHalo& Star 14 * t, 
kfleeperDialog StaflAtl) & 20ML, 
kUeeporDialog St<»117 ~ 4* 
kBe€peri>lalfi£_SL4itl/lD • 2D51L, 
kBe^ppi F Dljito^E<Uil!i ■* 5 . 
kBe*p<irtHnlof_Kditl5ID * 2D52L, 

Bee jk* r I)1 a 1 og_ End 

I ; 

The member function GetIntValue() retrieves the 
value from the Held that calls it (in this case, the editable text 
field), translates the value into an integer, and returns it. The 
loop uses tills value to Sleep the specified number of times. 

* Go to the top of the file and remove the comment 
characters (//) at the 1 beginning of the line: 

f I itncUifo “AppCtPiomandE.h" 

You'll need to do this last step whenever your view 
includes at least 1 command. 

* Close tlieeperDialogcp, 

* Open the file CBeeperDialog.h and add this member 
function declaration to the public section of the 
CBceperDialog class: 

void DtiCradHttepO : 


That's it! When you run the program, the Main view should 
appear, featuring a brand new' button (Figure 10). 



IHgure tO . The Main view, with the Beeper.,, button pressed 

Press the Beeper*., button. The Beeper Dialog wail 
appear Type a number in the text field and press the Beep 
button. Happy? 


Number of tiroes to beep: 

( Cancel ~~] 



Figure / / Pressing the Beep button 


Till Next Month,,, 


Nexi month, well go back to PowerPhmt 
CW7, and I’m anxious to dig into it, 
upgrades, too. See you next month... 


I just got my copy of 
Hope you got your 

m 


Visit MacTech Magazine’s Web site! 

http://www.mactech .com 
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I PROGRAMMER'S 
CHALLENGE 


By Boh Bvomtra, WestfonI, Massachusetts 



Enclosing Bounds 

Ihe Challenge litis month is based on a suggestion by Mike 
Setnlin, who remains a fan of the column, (We're still waiting 
fur Mike s first Challenge entry, however.) The problem is u> 
write a routine that will return a rectangle enclosing all non* 
white pixels in a selected area of an image. This code might 
lx.* useful in a drawing or painting program, where the user 
would be a 1 Iowa I to select a subset of the image by clicking 
and dragging, and the software would select all of the 
elements of the image contained within that selection, The 
prototype of ihe code you will write is: 

void Km liml tig hound s( 

P ; >M;jp]iimd It? pm , P handle in PixMap containing image 7 

Gee l selection T P subset of iimgi to enclose 7 

He c t * e n c 1 o $ i n g R p. c t P endt ksi i in red return value 7 

)t 

Your code should examine all of the pixels within the 
selection rectangle of the PixMap and return the smallest 
rectangle containing alt of the non-white pixels. Pixels 
outside the selection rectangle should Ik 1 ignored. The 
bounds rectangle of the PixMup will be no larger than 2(ViH 
pixels in each dimension, the baseAddr pointer will he 
longword aligned, and rowBy l es will lie a multifile of 4, 
You should deal with pixel Size; values of 1, E, or 32, with 
values of 8 and 32 being weighted must heavily In measuring 
performance. For P lx Maps with indexed pixels 
(cmpCounL^l), the color table will contain white as the 
first table entry (as all good color tables are supposed to). 
For PixMaps with direct pixels, ihe unused (alpha) bits of 
each pixel will be zero. 

You may use either the Metro we rks or the Symantec 
compilers for this native PowerPC Challenge. It you have any 


questions, or would like some test data for your code, please 
send me e mail at one of the Programmer's Challenge 
addresses, or directly to boonstra#u!tranclx'om. 

Two Months Ago Winner 

Congra tu la lions to Eric Lengyel (Blacksburg, VA) for submitting 
the fastest and smallest entry to the Reversible Scrambling 
Algorithm Challenge. Despite an unfortunate delay in publicaiinn 
of the magazine that left participants with less time than usual to 
complete the Challenge!, three of the four entries I received by 
the extended deadline worked correctly, at least in part 

You might recall that the Challenge was to write code that 
would raise a large integer message to a power ant! compute 
the remainder modulo another large integer. The name of the 
Challenge comes from the fact that this technique is reversible, 
given properly chosen integers. Eric is a graduate student in 
Mathematics at Virginia Tech, and lie took advantage of a higlily 
optimized multiple precision integer arithmetic library that he 
had written as part of a numlxr theory project involving die 
factorization of very large numbers. 

Each of the working entries converted the BigNum 
representation provided in the problem into one that rigtu- 
justified numbers into a fixed-length data structure. While this 
Imposes a restriction on the maximum size integer that the code 
can handle, this assumption was permitted by the problem 
statement. In Eric's code, the restriction is controlled by a 
single //define statement. 

Eric uses a binary exponentiation algorithm to raise the 
message to the specified power, and takes advantage of facts 
from nuinlxjr theory that allow' the remainder ro be computed at 
each step of the exponentiation. The time to perform the 
exponentiation is therefore proportional to the logarithm of the 


Here's how it works: Each month we present a new 
programming challenge here. First, write *>me axle tluit solves 
the challenge Second, optimize your code (a lot). Then, submit your 
solution to MacTech magazine. We choose a winner based on code 
correctness, speed, size, and elegance t in dial order of importance) us wdl as 
the submission date, tn die event of multiple equally desirable solutions, we II 
choose one winner (With honorable mention, but no prize, given to the 
runnel tip). Hie prize for each month's Ix-sr solution is a $ LOG credit in die 
MarTech Mail Order Store and a Jimlted-edirion, “The Winner! MacTvch 
Programmers Challenge" T-slUrf (not available in stoics anywhere). 

Unless stated iXhcTwist' in tin 1 pruNem statement, the following niks, apply: 
All solutions eiuN lx- in AXSI compatible (. Use only pure C code We disqualify 
entries with any assembly in them (except for challenges specifically stated 
edierwisej, You may call uny MurinUjsh T<X)R)qx nxitine (e.g.. it ikxrari matter if 
you use Vwllr tusic.ul of malioc), We test entries with compiler ujXions set to 
disable PEI use (Its riKlJxO code) and to enable all avail.iNe speed opUmiZalkm 
Ihe compiler to he used and the targii instmctioii set (680x0 or PtiwerPC) will be 


stated in the problem limit your code to 60 characters per lint* 

tills helps w ith e-mail gateways and ptge layout. 

We publish the 1 solution and winners For lids months Programmer's 
Challenge two months luier. All submissions must lx- received by die 10th 
day of the month primed on the front cover of this issue. 

You can get a head start on the challenge by reading the online version. 
We post it to (he online services at the same lime that we post source code 
We make every effort to have it online no later than when the magazines are 
mailed, but we’re unable to guarantee that it will be online by any given date 
Mark solutions Arm Programmer’s Challenge Solution* and send it by 
e-mail Ui one of the Programmer’s Challenge addresses in the “How to 
Communicate Willi Us .section on page 2 of this issue. Include the solution, 
all related files, and ytwr contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
rhe Programmers Challenge. Authors grant MacTech Magazine ilk: exclusive 
tight let publish entries without limitation upon submission of each entry 
Author* retain copyrights for the code. 
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JointSolutions Marketing 

408/338 6471 
408/338 6475 (fax) 
jsolver^aoLcom (e-mail) 


JOINTS 


MAKKETfNr, 


Get Net Wise... NOW! 


J ointSolutions Marketing is now creating 
exciting World Wide Wfeb pages for various 
clients, including Apple Computer, Inc. 

Wfe can also assist you with all aspects of data¬ 
base publishing and interface design. 

Call for the Web addresses of our latest projects. 

Don't miss this opportunity to reach your 
target audience. Call today! 


* Web Page Design 

* btml Conversion 
and Screen Design 

* interface Design 

* Database Publishing 

* Project Management 


exponent, Erie's multiplication and division routines use the 
68G20's capability lo compute the 64-bit product of two 
longwonds and to divide a 64-bit dividend by a longword, The 
multiplication, division, exponentiation, and compare routines 
in Erie's ctxle are general purpose and could be used in any 
68 K application that needs large integers. 

Honorable mention goes to Ernst Munter, who submitted 
an entry in pure C that was actually the fasiesi code for the 
short modulus test cases, UnforUinaLdy, his entry' did nor 
produce correct results for ihe longer moduli. 

Here are the times and code sizes for the entries that 
worked correctly (or partially correctly). Execution time is 
presented for two specific lest cases, with modulus lengths of 
22 and 88 bytes, respectively, as well as the total time for all of 
the test cases I rare Cases that produced Incorrect results are 
indicated with an asterisk. Numbers in parens after a person s 
name indicate that person's cumulative point total for all 
previous Challenges, not including this one. 


Name 

time I time 2 

Total time 

code 

data 

(22 bytes) (88 bytes) 

Eric Ijmgyd 

47 463 

2083 

1190 

0 

Xan (ireftg (51 > 

3S %1 

3175 


0 

Ernst Muntcf (C entry) (90) 17 

■ 

4266 

11788 


Top 20 CONTESTAWTS OF AlX TI Mi¬ 
ll ere are the Top 20 Contestants for the Programmer’s 
Challenges to date. The numbers below include points 
awarded for this month's entrants. (Note: ties are listed 
alphabetically by last name - there are more than 20 people 
listed this month because of ties.) 


Hank 

Name 

Points 

t 

[Name deleted] 

176 

2. 

Mu nice Ernst 

90 

3. 

Karsh, Bill 

78 

4. 

Stenger. Allen 

65 

5. 

Gregg, Xan 

61 

6. 

Larsson, Gustav 

60 

% 

Riha, Stepan 

5J 

8. 

Goebel, James 

49 

% 

Nepsund, Ronald 

r 

10, 

C tilts, Kevin 

46 

It, 

Mallett, Jeff 

44 

12, 

Kasparian. Rafll 

42 

13. 

Vineyard, Jeremy 

42 

14, 

Darrah, Dave 

31 

15~ 

Htnclry, Larry 

29 

16, 

Elwertowski. Tom 

24 
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17. 

Lee t Johnny 

22 

18. 

Noll, Robert 

n 

19. 

Antlerson, Troy 

20 

20 

licith, Cary 

20 

21 

Burgoyne. Niek 

20 

22 

Galway, Will 

20 

23 

hraelson, Sieve 

20 

24. 

bmdwdKT. Greg 

20 

25, 

Lengyel, Erie 

ffl 

26, 

Pinkerton, Tom 

20 


Them are three ways to earn points: (i) scoring in the top 
5 of any Challenge ( ( 2 ) Ix'ing the first person to find a hug in a 
published winning solution or, ( 3 ) being the first person to 
suggest a Challenge that I use- The jxiints you can win are: 


1 st place 

20 ptnnis 

2 nd place 

10 jxdms 

3 rd place 

7 points 

4th place 

4 points 

5th place 

2 points 

finding hug 

2 jxiints 

suggesling Challenge 

2 points 


Here is Eric's winning solution: 


POWLKAN0RliMAiNDER.C 

Ccjpynght C |W Frit tfftgyd 

r 

t rail my fun! Irani h numbers ami iransbtc frtim BigNucrV* in t)jgbird\ m 

tin- nmrrAmltkmaimk'r nniitiK 11 nx arc itv aManbh Unpiupi nkituu-s wturfi an 
tin pfl* of my pnipNiTi 

(1} - raise* i number Vu a p*wt r and reduces it by a module It uses a fast 

binary cxpufit-ntiaium aipnriihm. tidtiiina by the iwniulus at each sicp, 

(2) Multiply * multiplies 2 %Sii*m * mfgcthcr 
0) Mulrtj - mntltplu-s a Ni^Num h> a long im 

(4) ISvhIt divide* (me BigNum by imrther ami Mippbo the ijutMunt add ivmaimXr 
(S > t omp.i it- determine* I hr i ink ting < if 1 HtgNum' v 

Some or ilk loopy iuu been expanded to make inuir cfikkrrt use of tik imtaJOtun 
cad nr 

7 

Idefine NiihS I xr 77 . 
typeduf struct Bigtfum 

t 

short miraDig: 

unsigned char *di r; 

I BiftNun: 

typftrfcf sirurt Ri&FUH 

unsigned char dlglWu»$Ue*4l: 

I BigFixed; 

f Wc need kmp because the diviskm rueiunc nerds the must signifkani kmgwimJ 
to hr tem and die spml optimi/xtn m requires that SiimStTt he a muluplr of four 7 

vniii Have r Audi! cm* imlcr (HigNtw "nag, * exp , BigN.iv *b, 

HigNu* "tea): 

void PowcrModlBigEixeiJ "msg. Bigtixed 'exp, BigFixed *u, 
BigFixed *rcx); 

void Multiply(BigFixed “*rcL BigFlxed ‘grc2, BigFixed *dst>: 
void HuitQtBiftFixed *srcl, long arc2, BigFixcd *d«t); 


void Pivld^(BigFixfrd "end* BlgFixed "sor* Bigflxed *dst); 
short CoaparoUigPixed ‘frel* 8igFix*d *src2J; 


TVmicrAmJRcraainder 

void Powi i AnrlRcKjlndi'r (AigNit* "*£g, *HgNu* "exp, BlgNun "0. 
BlgMu* *ro&) 

short d, b. nusOlgU®; 

BlgFixed asgO. expo. nO, resO; 

for (n * Q; a < ItmiSirr**; »*+) 

* 

b " NuinSixc'A nzg >nuii!)lg; 

11 In < h) isaU.digtiiJ - 0: 

olsu BsgO.dlg lal - B;ig - ><U(j>l« b| ; 

b - KumSixe*^ exp >miaDiju 

if (a < b) expo, dig U1 - 0: 

flxi* axpO.dlfiUl " rtspOdlgfo hi; 

h ” Nu»Slxo*4 n >mi»DJg; 

if In < b) nU.digjul " 0; 
oiisif nO.digUJ “ n >dli|a bj; 

I 

PoverHodttiasftO* 6exp0. knO, 4ros0); 
a - 0; 

wfuto irirO.fl lg[fl) — 0) a*!- 
mmnigf tn * res >minDig * NmtiSIxr'H n; 
for tb * 0; b < nuaOi|lu: b+fj 
iva >dig|bj * rvsO^digta^l t 

[ 


hrwcrUod 

void PcnmrKodfBfftFIxod *(SBg. fUeFIx^d Vxp f BigF'fXpd *n m 
fllgFixcd "resj 
t 

higFixod see * scrap; 


dsn 

i 


UtA 

a rf. Aft 


Mart with unc in 

KOVFQ 

0NunSixo/4 2. DO 

t 

amimulaiof 

r/. cut a 

(AD) + 



CU.L 

Uo)+ 



CLK. L 

l A0) + 



CLR.L 

{A0) + 



DBF 

do. n 



CUt. L 

(A0) t 



CTJU, 

(A0) + 



ClJt.l 

(ACt) + 



HUVKU 

ll< IK) 



HOVB.L 

DO, (A0) 



KOVEA.L 

exp. AO 

; 

hui adUroA of 



j 

expunem in AO 

cun. y 

D2 

; 

D1 Imkh fx?Mi n>n 



» 

m exponent 

TST.t, 

00(A0, D^.WM) 


kind first hni^wiml 



f- 

of rtpoorm 

m 



which is ikk zem 

cm'i.u 

#NunSix*'i. D2 



BEtl 


1 

if riuirv cxjKitkm 



. 

Is zem, kravc 

ADDQ*W 

ll* 03 



BRA 

#0 



H4 CUt.f* 

QJ 

i 

Rl hobLs rhe Nr > 

m pEhA 

uec 

* 

Sr pure .Kiiimubtur 

m 

Mbc 



FEA 

ICC 



J5R 

Multiply 



ADDA,¥ 

In. A7 



MOVE.L 

n* *(A7l 


O impart mj cumubUtr 

FRA 

ACC 

* 

n* tmxJulm 

JSR 

Compare 



AIIPQ.U 

#8, A/ 



TST.1I 

DO 



BH1 

wt 

A 

if it * k’s*. slip 




fcdatiiun 

PEA 

scrap 

• 

Rctkkc juumidafuf 



t 

mndtlkr V 

MOVK.Ii 

n, (A71 

I 

(KxrtkOt not needed. 

FRA 

arc 


Mnrr m "Mmp' 

JS» 

Divide 
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ADBA.W 

#12. A7 


«X WOVE * V 

Dl, topStop 


m BFT5T 

00(AO, D2.U*A)ID1:1I 

; Test a bit in current 

SB CULL 

OOCA2, D1,W*A) 

; (Jear leading k>ngwnnls 


t 

kjftgwofil ttf exponent 

DIF 

01. OB 

; of pirtia) pmdua 

MQ 

#i ; 

If zero, skip multiply 

ADDA,¥ 

iHuwSlrc * 4. 

Ah ; Afld M/r 

PEA 

met ; 

Multiply anitmiiUtur 

CULL 

DZ 

; D2 is carrj register 

m 

«cc ; 

by base 

HOVE.L 

U0(A3, D4*W*4) 

, . lia king word fnan 

HOVE.L 

■sr. (A/) 




; luaurni numba 

JSC 

Multiply 


HOVEQ 

fKtmSixe * l t 

D3 ; 113 bukb pusitkm 

AOOA.U 

112. hi 




, in product 

HOVE.L 

a. -(A7) ; 

(* impure accumulator 

#1 HOVE.L 

D7. D5 

, f opy kwigntoai io 1)4 

PEA 

•cc ; 

to modulus 

HI1LU.L 

(A4). 06:0*5 

; Dofo-bif muhipk 


Con parr* 


mnx 

02. D5 

Add cam in low 

AOIXl.tt 

#*. a; 




iongwnal of product 

TST.B 

00 


CLR.L 

02 

. Ifsc D2 as dunum to 

liMI 

*1 ; 

11 it s less, slip 



. extend carry 


i 

reduction 

ADDX,L 

02, D6 

. Add zero to high 

PEA 

scrap i 

Reduce modulo ~n" 



. Jongword wiib earn’ 

MOVK.L 

n. • (A7) 


HOVE.L 

06. 02 

; Anything in high 

PEA 

mrx 




Lmgword gets carried 

JSR 

Divide 


HOVE.L 

0b, 00 ( Al , 03■ 

W’4) ; Stna j km 1 longw unt its 

AIIUA.H 

#12. A/ 




. partial produci 

01 AIUHJ.W 

#1. oi : 

Increase bis number 

SUBU.H 

ii. 03 

; loop througli all 

CMP LB 

#32. 01 


CHILV 

topStop. D3 

; kmgwntds in nrp number 

BLT 

*2 ; 

If < $L loop 

BCE 

01 


ADDQ.W 

fi* D2 ; 

Increase kinguord * 

HOVKA.l* 

A2, A0 

; Mow add partial pitnluct 

CHPT.tf 

fWimSliui. D2 




; to accumulator 

5LT 

w ; 

If < numbe r sire. Imp 

HOVE.L 

1)4, DO 

, ( jIujI.iic correct 

LKA 

arc . Ati ; 

t jopv acc In "res’ 



; pt&Rktfi In product 

HOVEA.L 

res. Al 


LEA 

ace, Al 

<*ci accumulator^ addr 

HOVEU 

#Nua:Uie/« l. DO 


ADDQ.W 

tu DO 


•3 HOVE.L 

(AO)♦. (All* 


ADDA.W 

jHmiSixt * 4, 

AQ 

HOVE.L 

(AO)*. (AD* 


LSL.V 

il. DO 


mux 

(AO)*. (Al)* 


ADDA.W 

DO, Al 


mnx 

(A0)+. (AD+ 


HOVE-W 

04. ill 


DBF 

do* m 


HOVE.L 

(AD. DO 

; t»et koiigwonl **l product 

i 



sum 

ii, Dl 


\ 



mnx 

(AO), DO 

; -Add (tmgword uf 




HOVE.L 

DO. (Al) 

partial product 



Multiply 

1ST. W 

01 

, if rm more- tongwnrds, 




MHI 

m 

; then hrrndi 

t Multiply srel by mv 2 ami pm pnidmi in lUt V 

m ADDX,L 

(A0>, (Al) 

. Add next tongwonJ 




DBF 

Di, #3 

; Ump (tin High 

void HulUplytMgFixed *»tel, HgFlxed 'erel. BigFixed m dst) 



autre pmdua 

i 



•2 SUBQ.W 

11, 04 

, Loop and do next 

short 

tnpStop. butStop; 


CHK.W 

borStap, 04 

; k*r^iad of bntlom * 

RiftKlx**d 

acc. linn; 


BCR 

#4 





#8 LEA 

nee. AO 

Copy product to "ifel* 

ail 



HOVEA.L 

<tsi. Al 


[ 



HOVEQ 

lfiunSitc/4‘1, 

DO 

MOVER.L 

m D//A0 A4. *IA/) 


#5 HOVE.L 

(AO)+, (Al) 4 


LEA 

acc, AO ; 

Clear accumulator 

HOVE.L 

(AO) 4 , (At) 4 


HOVEQ 

iMinSlst/Vlt DO 


HOVE.L 

(AO) *. (AIM 


iZ CLR.L 

(AO) i 


HOVE.L 

(AO) 1, (Am 


QMX 

(AO) + 


DBF 

no, i r i 


CUt A* 

(An ) 4 


HOVKH.L 

(A/)+. UO U//AU AA 

CULL 

(All) 4 


1 



mv 

do* m. 


1 



LEA 

lint, Al ; 

Mine' holds pant.il 






products 




KOVEA.L 

arcl. A3 ; 

M#ivc bottom number s 

/' Multiply sa 1 bv >tx2 and pul pfodiid in vbt 7 

Oft.W 

Dl : 

a thlrrss Into A3 




m TST.J. 

(TO(A3, CH.11*41 ; 

Kind lirst non-rem 

void Mu]t(l(HlRFtxi*d 'liii; t. 

lung nrcl. HJgKixt-d 4 dal] 

nm 

•7 

long word of bottom * 

I 



Alsou. W 

tl* 01 


BiRFUed 

pro; 


CWFJ.W 

iNunHix*. Dl ; 

ll Ihiiiuhi manlier O. 




BEQ 

m : 

go to end 

tan 



BRA 

#6 ; 

Loop 

\ 



•? mu.\t 

Dl. bntStop 


HOVKH.L 

W) 02/AO/At. 

U?) 

hovhq 

flttntftKQ 1* 04 ; 

IM holds position in 

LKA 

pro. AO 

; t k'jr ptrudix t 



boom number 

HOVEQ 

fXurtlirM 1. 

DO 

#4 HOVEA.L 

arcl, M ; 

Move lop number > 

WL CUt.L 

(A0) + 


CUf.tf 

Dl : 

jddft-s* Into A4 

CLE.L 

(A01 + 


#9 TSia 

00<A4. 01*0*4) ; 

Find first non /cm 

OB-l 

1*0) ♦ 


BNE 

#A 

hingwordnf tup* 

CUU. 

(AO)* 


ADDQ.W 

Il di 


DBF 

DO. m. 


OtFT.W 

lHnaSi/p. 01 ; 

If top number /rro, 

LEA 

pro. Al 

, (ki ai klrev* esf 

HF.Q 

H 

go to end 



. pmducl 

BRA 

«9 : 

Loop 

HOVEA.L 

srcl. AO 

Move top rmmbcT s 

*A SUBQ.W 

1), Dl 


CLH.W 

01 

i address into AO 

BPL 

#x 


il TST.L 

OOtAO, Dl-U*A) 

. Hnd first non-zero 

Ctt.W 

Dl 


BNR 

m 

; kingwurd of top * 


MultQ 
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Source Surfer. 


Introducing the incoming wave in Mac development tools: BBEdit 3.5. This radical text editor provides an 
amazing variety of ways to browse, search, and surf through your projects. 


Let's Go Surfing, 

BliRdit's integrated disk browser provides you with 
a quick and easy means of navigating any mounted 
volume. It's the ideal tool for exploring developer and 
K.T.O. CDs . BBEdit also has the unique ability to open 
multiple THINK or CodeWamor project documents, 
either for browsing or searching. 

Can't Find It? Just Ask. 

At the heart of BB Ed it's surfing ability is a powerful 
engine for searching text, either literally or with 
UNlX™-stylc "grep" patterns. This search engine is 
coupled to multi-file directory scanning, and the 
ability to search currently open windows, previously 
searched files, or project documents (even if your 
development environment isn't running). The new 
"Quick Search" capability gives interactive searching 
as you type. So even if you don't know what you're 
looking for, BBEdit can find it. 

Project Your Feelings, 

All of 1 his great capability would he wasted if you 
couldn't use BBEdit to w rite code. That's why we've 
incorporated awareness of Projector, direct support 
for ToolServer, and seamless integration as an 
external editor for use with T1IINK C/Symantec C++ 
(version 6.0 and Liter), as well as support for control 
of Melrowerks CodeWamor (version 1.2 and later). 

We Beg To Diff, 

BBEdit's unique ability to compare folders and 
projects makes it a natural for figuring out which 
changes you made at 3 AM the night before. 


For more information: 


We caught the wave. 

In addition to its renowned surfing abilities, 

BBEdit supports the latest system software 
technologies: Apple Guide, AppleScript, Macintosh 
Drag and Drop, PowerTalk, PowerPC acceleration, 
and Quickdraw GX printing. There are goodies to 
make your life easier: "soft" text wrapping, 
automatic linefeed translation, parenthesis 
balancing, auto-indent, and more. You can also 
extend BBEdit with plug-in code modules. 

(We provide information and examples to help.) 

We are the wave. 

Since its first commercial release in 1993, BBEdit 
has set the pace for capability, user interface, 
functionality, and customer support that others 
are still trying to emulate. BBEdit was the first 
editor to support ToolServer, T1 JINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, and 
the leading-edge technologies mentioned above. 
We're still setting the pace fur others to follow, as 
the first Mac text-editing solution to deliver on 
CD-ROM with on-board documentation, the first 
text editor to support the Internet Con fig system, 
and the first development tool with Apple Guide. 

"I Tried it Once, But Didn't inhale," 

We’ve painted a great picture, but don't take our 
word for it. Take a deep breath, hit our FTP site 
(see below) and see for yourself. You'll find lots 
of things to like. 

BBEdit. It doesn't suck. 


Aocdoaied for 
Puutr Macintosh 


4 


Mac OS 


B 


Bare Bones 

SulhMli lilt 


talc met: bbsw^nc lcom.com 
CompuServe: 73051,3255 
Appldink: BARE.BONES 
eWorld: Bare Bones 

ftp: / / ftp.netcom.com/ pub/ bb/ bbsw / 


We aIw have II doesn't stick" I shlrls that dnrit either Call us tn order 01995 Bare Satifs Software, Jnc F.O Bov 106 Bedford, MA 01730 voice 508,651,3561 fitoc 50&6S3/75S4 
Our lawyers inslm we say UBEdlt. PopupFuno and nur spiff y logo are trademarks of Bare thirties Software,. Inc. Mac and ihe Mac QS logo are trademarks of Apple Computer, Trie,, 
used under liamw PowerPC i* a trademark of IjiternattonoL Business Machines Corporation All other trademarks and registered trademarks arc prnperMcs of their respective holders. 
BBEdit vvvuj produced without hair spray, asparttmt f w artlfiwl colon, And onty a few gctfetls were Incofiysniencid during testloj; and production 














Power Mac and 
Macintosh 
Oevelopers 


Wt 

rwi 




THE MEMORY MINE 


FIND OUT FAST 
WHAT'S GOING ON 
IN MEMORY 


r*YKk 

r Divide end (iflvkknd) hy mw tdiYtsoo and put quntiml rn dn Rrmamtlrr will end 
up <n end V 

void OlvidedlgPixod nd, nigHKed *«or. Bigfised *dst) 

i 

long pq; 

BigFixed quo. line: 

msm 


* See memory allocation in any open heap at a glance. 

* Easily spot memory leaks, 

- Flags heap corruption when it happens. 

"• Works with source level debugger to let you find memory problems fast 
Stress applications on the fly with Purge, Compact, and Zap. 

Allocate memory at will for precise stress testing. 

* tog heap data - easily document heap status over time. 

■* No need for source code: nothing inserted in code; no patches 
to the system. 

•* Works with 24-bit, 32-Wt. and modem memory managers. 

Fur UacmtoJiit with 60020 or totfcp. Roqunes SysioTi 7.0 or fcstm 

only $99 US 

Order now from Adianta, Inc. 

Phono. (415)781-8052 • FAX; (415)781-8053 
AppleLink; ADI ANl A • AOL. Adianta • lntemel:adianla ® aolcom 
For VtSAMC, or American F.xprcss orders by mail, lax, or Apptebnk, please include 
name address, card numbst, reparation dare, and phone number or email address 
Also available through the MacTbch Mail Oder Storo and APDA 
lor more irrtcirmation contact 

^VAdumta, tnc. * 5W2 Market St #911 • San Francisco,CA 94TU4 



APDQ.W 

It. Dl 
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iKunS1 ip K DO 
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CULL 

m 

t)2 b cany register 
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mu.i 

DO (AO* DQ.tf*4), DA 

lk‘i hmgword of 
lop number 


HULU.L 

P7. U5;D h 

Do M-hil multiply 
\w bmroni number 


ADftJ. 

m t DA 

Add cam' 


CULL 

OS 

Use 1)2 as dummy to 
extend carry 


adihll 

02, D5 

Add /.t'fTj wilJi cany 


MOVK-L 

0*i. D2 

High lungwort! 
bccomei ony 


HOVE.L 

UA, 00CA1. 00*11*4) 

lAu panial product 
into result 


Subq.u 

#K DO 

loop through iD 


ofp.ii 

OK 00 

knigword* in lop * 



fl 


in 

LEA 

pro. A0 

Copy product lo ‘ds*' 


hovea.l 

dit. A1 



HOVEQ 

fNuaSiip/4-1. 00 


m 

hovb.l 

(AO)*. (Al)+ 
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(A0I+. {All* 



HDMLL 

(A0)+. (A1I+ 



MOViU, 

(A0)+. (AIK 



DBF 

00. t>7 



HUVEH.L 

fA/)+. D0-D7/A0/AI 



1 

I 


t 


WOVKM.L 

DO D2/A0 AK (A/) 


LF.A 

iino, AO 

; Utar ijin n lent 

H0VEQ 

WtmSlzefk l * DO 

n GULL 

{A0) + 


CLR.L 

(AO) f 


CLR.L 

(A0)i 


CMl.l. 

(AD)* 


DRP 

do- m. 


HCWKA.L 

end* Ad 

Move dividend^ 

; acklrr» into AD 

CLR-tf 

DO 

; DO oimiim current 
; poMttun in dividend 

H0VEA.L 

&or, Al 

i Movr divisor s addr 

CTJLV 

Dl 

* into A1 

n TST.L 

00(AK 0KM # 4) 

Hits bop tmd* ibe 

first nori V4.rn 

mt 

•6 

* kn^wunJ of ibc dnwir 

addq.w 

11. Dt 

4 M(*n> the pop* in J>1 

&RA 

•2 

; Loop until xnmrthmg 

; 

m TST.L 

od(ao. no.u*4) 

Rod fiiM ItMigwtmi 

BNF 

01 

. uf dividend 

AUiKJ.V 

#K DO 


CM FKH 

lNi»Sis«. 1>U 

IT wlmk dividaKl aero. 

m 

m\ 

; grim end 

&RA 

0G 

; Ump 

m LEA 

qno, A2 

; Address of qiHHit-m 
b >i tired in A2 

M0VEQ 

fMnnStae, D2 

. t>2 cuoiains eurmw 

|HiMtu»n m ijudtiaiL 

SUB, y 

DK D2 

i irsi {KiMfjtin will 

StJBQ-W 

Ik m 

be NnmSi/e -1)1 

CHP.tf 

DO, Dl 

; If dividend smaller 
, (tun drvcwir, 

RLE 

m 

, thenpHoml 

AMJ.U 

DO, 02 

; Add roqUMdeiiL jms 

0C CULL 

PI* 

, *pq* h*i4b jwmal 

i quuti4.nl> 

#9 MUVK.L 

00(AO, D0.W4), Dl 

. Take a tfuadwunHmfn 
dividend tu ttn 

HOVE,L 

04(A0. D0.W-4), 04 

; as pamal dividend 

K0VE.L 

DtHAl. DL.V4). D*i 

Ik d^ 

Takr a kmgwi ini from 
divisor ami 

ADDQ.L 

adit one 

SHE 

#e 

; If divisor not zero, 
gu do diviMon 

MOVE * L 

di, m 

Live, we arv dividing 
; by 111)0111, so mine 

BRA 

#K 

; high lung word of 
divkk'ml into (jminefn 

HE DiVtLL 

DK Dltn4 

, 1 hi rliv^Hin 

EF RRQ 

tn 

Branch il quoiinit zero 

ADO. L 

DA, pq 

Aikl tjuiHienl m 
partul quotient 

PEA 

lilt# 

. Muliiph qiHHicm 
; by dh fcsuf 

H0VE.L 

DA, -(A?) 

; and viurr ni ‘line’ 

HOVE,L 
JS« 

ADDA.V 
LEA 

Kor* (A7) 

HOI 10 
#12, A/ 
line, AJ 

iNmaSia# - 4. A3 

<kt qunuem^lnbor 

prndiKi 

A0DA.W 

; Now sutxrait 
: Immilivitkixi 


M0VEA,L 

AO. A4 

( pv (Iivuiemt JI klr t< i VI 

H0VE.L 

02. B5 

. T)2 bukb kiwr^ po?* 

T*Sf.,W 

D5 

. of dividend U i mjD fn ini 

AUUA.W 

L>S, A4 

; ,\ild il to parUal 

M0VEQ 

iNumSlKe. 07 

; dividend adda'xs 
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Gives you the Information to Pr ogram your Best ! 



Information 


The Debugger V2 
& MacNosy 

by Sieve 'Jasik^ 



Control 


hfi Debugger Is □ low and high-level symbolic 
Debugger that runs in a full multi-window 
Macintosh environment You can trace program exe 
cation. view the values of variables* etc, of both 6SK and 
PowerPC programs 

Mac Nosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica¬ 
tion* resource file or the ROM. 

When you compare features of the different debuggers* 
note ihat onto/ one has all the below features to help you get 
your Job done, and mhf one has MacNosy to help you debug 
any program in a full system [6.Ox or System 7.x) environ 
mrni symbolicaily! 

It Is the mib/ debugger io use the MMU to protect your 
CODE resources and the rest of the system from the pro 
gram you arc debugging. With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe. 
Aldus, Claris. Electronic Arts, Kodak, Melrowcrks, etc. 



=["!■■- —IUmdoiiiRecord_<*>46532Q H 

u i ndoiuRecord 

o 

0 port 

CGro f Por t JP465320 TTT^T 

108 m j ndowK i nd 

8 

110 visible 

TRUE 

111 hi 1i ted 

TRUE 

112 gofiwagF 1 ag 

TRUE 

J13 spareF1qg 

TRUE 

114 strucRgn 

Regiorv_@488974 

118 contBgn 

* -Reg i on^4B5534 ~ 

122 updateRgn 

* *Regian_£4859B0 ^ 

126 mndowDefProc 

-"OEF funRsrc_e3768F0 8 

130 dataHandle 

@485070 

134 t» UeHarKlIe 

@485918 “ “Urtt i t led- t" jig 

138 it tleUidth 

67 

140 ControlList 

NIL 

144 nextUmdour 

*W i rKfcM»Record_@465278 

148 m t rwlowP i C 

NIL pZ] 

152 refCon 

$00464F28 |g 


An example of a structured data display window 


Its Features Include: 

• Symbolic Debugging of am/ Macintosh program. ROM, or 
axle wsource (DRVRs, XCMDs. INfTs, PDEFs. 4DEXs „) 

• Source level debugging for Metrowerks 8 1 MFW compiled 
programs {C++, C, Pascal. Fortran.J. and an Incremental 
Build System with instant link for super fast development. 

• Object Inspector for MacApp 3 programs 

• Source level debugging of Think C™ projects 

• Includes a program (CoverTest) to Interactively do Code 
Coverage analysis for SQA testing, etc, 

• Simultaneous Symbolic debugging of multiple “tasks'’ 

• Fast Software Watchpoint command to find clobbered 
variables 

• Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
ihey become disasters 

• Structured display of data (hypertext) with user definable 
structures while debugging 

• Conditional breakpoints lo help filter out redundant 
information 

• Continuous Animated Step Mode to watch your program 
execute instruction by instruction 

• Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps. - 
make it possihle to ferret out the secrets of the ROM, etc. 

• ‘Training Wheels’ for the PowerPC disassembler to help 
you learn the opcodes 

The Debugger V2 ft MacNosy: $350 

Runs on all Macs, Call For Croup prices or Updates. 
Visa/MC Accepted. 

Available from: Jasik. APDA. Frameworks or 
ComputerWare (800-326-0092). 



Jasik Designs • 343 Trenton Way. Menlo Park, California 94025 • (415) 322-1386 

Internet: macnosy@jaslh.com • Applelink: D1037 






























Superior 
Copy Protection 

t MACfiock mikes you money 

♦ MACjhtk ii SAFE*TRANSPARENT & EASY 

♦ MAC/fork if iggressively priced 

♦ M ACWock works on Mm & Power PCi 
+ NETt/ork provides LAN license control 

+ Rrnad Prod net Range lididef PARA/fock (PC) 

Spending $25+ for copy protection should get you more than a pretty dongle. 
Please Id us explain why MAC/iock's micro processor is superior to old 
fashioned ASIC technology. Call us TODAY and order your Developer API, 
We will also send a kit to get you started on filing your copyright application. 




EAGLE DATA 
PROTECTION 


800 - 909-3141 


On CompuServe GO PIRACY 

nus m tactswtoi • MiifeiC<y,UM mitt * r* 


CaTTODAY STReceTve a FREE 



SUB .H 

01, 02 


l F hfjkb number 

SUBQ.V 

ft, 07 


luugwunk to suhtraet 

SHI 

05 



HOVE.L 

<M). i>6 

Subtract least 

StlBJ, 

(All. 

06 

kmgwords 

HOVE.L 

06, IA4) 


TST.B 

05 


If there ajenot any 




more lungwurds 

ME 

0B 


to subtract. branch 

0A SUM. 1 

£A3), 

-(M) 

Subtract nest tif 

DBF 

07, 0A 


kmgwuriLs with homiw 

0B BRA 

114 


loop and divide again 

0D HOVE.L 

ji q, nk 


Get -it t nmiiljii i! 




partial quotient 

#8 HOVE♦L 

00, D5 


Now dicck to >cc 

ADDO.L 

ft. D5 


if pani.il dividend to 

MOVE.L 

01. 06 


(eis than divisor 

#5 HOVE.L 

00(At. 

Qfi.W'i), 07 

tin longwurd ol divisor 

CMP.l* 

00(AO. 

ns.»•*), t)7 

Compare with longword 




of dividend, branch 

RCS 

m 


if dividend bigger 

BNK 

•4 


If divisor trigger 




ihcn branch 

ADOQ.L 

ft, 05 


if these two fctfltfWOftb 

ADDQ.L 

fl, 06 


were s, then enmpare 

CHP.0 

02, 05 


non r wn kipgwiinis and 

BLE 

•5 


t urn mix 

m KOVEA.L 

A), A! 


Mitniram dto but from 

ADOA.U 

fKij»$U* * A, AI 

partial dividend 


KOVEA.L 
HOVE.L 
LSL. W 
KOVEQ 

ADOA.U 

sim.v 

SIMHJ.V 

SHI 


AO, A A 
02, 05 
12, 05 

|p#i m 

05, AA 
01, 07 
#2, 02 
05 


HOVE.L 

(At). D6 


SUB. L 

-(A3). D6 


HOVE,L 

D6. (AO 


TST.B 

DJ 


9NF 

M 


•7 SUBX.L 

(A3). (AA) 


DBF 

D7. #7 


06 ADDQ.L 

#1. DA ; 

Add *mc in quotient 

BRA 

M j 

lamp and enmpare again 

04 HOVE.L 

DA. 00(A2. D2.WM) ; 

Storr partial quotient 


1 

in whole quotient 

AODO.W 

fl. D2 

Increase qiKXxrn pas 

ADDQ.W 

#1. uo 

Increase dividend pus 

CHFl.W 

fHufflSlw, 02 


BLT 

#C 

, laxip uihH done 

VII LEA 

qua. AO 

(kipy quotient to “dst' 

MOVEA.L 

d*t. AI 

KtmiindtT will aitrnmai' 

HOVEO 

ftfunShw/t'lt DO 

n ally i ixl op 

no HOVR.L 

(A0] + . (AU + 

in dividend 

HOVE.L 

(AOH, (Al) + 


HiJVK.L 

(A0) + , (At 1 + 


HOVE.L 

(A01+ * (Al) + 


DBP 

DO, §0 


H0VEM.L 

CA7H. D0*D7/AQ-A4 



I 

I 


fjiKn|iiup 

T Compsc ml and s kZ Return* 1 if *rr I > m2, D if liR-v ct- opaL aml-1 if sn:t < 

rclV 

nhort CmHjMrf (EigFUed *arel. BlgFixed *src2j 

t 

•flfc 


KOVEM.L 

D1/D2/A0/AI, (A7) 


KOVEA.L 

&rel. AO 

; Gd wtfs atkka 

HOVEA.L 

nre2 t Ai 

t Wl ml* atkirrv, 

HOVEQ 

#i. no 

, Stan with+1 

HOVE.L 

(AB)+. 02 


CHF.L 

(Al)^. D2 

, ( timpate 1st lungwonb 

BLT 

01 

, If siv 1 Jess, tvrmc h 

BNE 

01 

; If !=, srcl musi 

HOVE.L 

(All) *, 02 

; hc‘ greau-r 

CHP.L 

(AU + . 02 

{jnp $ monc* kmgx rmls 

PCS 

01 

: (i rNgned) 

Btib 

02 


HOVE.L 

(A0)+. 02 


CHP.L 

(Al)+. 02 


BCS 

01 


BHE 

02 


HOVE.L 

(AO)«. D? 


C HIM 

(AI)+. 07 


BCS 

01 


m 

02 


HOVEQ 

iUimSize/ii l t DJ 

; Number of long words 
; remaining / 4 

HOVE.L 

(AOH. D2 

; (Compare i longwnrds 

CHP.L 

(AI)*. D2 


BCS 

01 


RHH 

02 


MOVK.L 

(A01+, D2 


CHP.L 

(AD+, 02 


BCS 

01 


&NF. 

02 


KOVE.L 

(AO)f, D2 
(AI)+, D2 


CHP.L 


BCS 

#1 


BHE 

02 


HOVE.L 

(AQ)+, D2 


CHP.L 

(A1J+, 02 


BCS 

01 


9ME 

§2 


DBF 

m. i5 

; tuop 

CLR.L 

DO 

, lfw?gcthcte. 

BHA 

02 

ll)U)Mll=MV2 

HOVEQ 

f i, DO 

; mi 1 b krss 

HOVEH.L 

(A73+, 01/D2/A0/A1 
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World's Leading FORTRAN 77 for Macintosh 


68K and Power Macintosh versions 

• full ANSI 77 native compiler 
•fasterexecution speed 

■graphical source-level debugging 

• two complete graphics packages 

• make utility, MRWE application framework 

• System 7.5 compatible, MPW included 

• Win do tvs 95/Nr version also available 


abssift 


Visit us now at http://www.absoft.com 


2781 Bond Street Rochester Hills MI 48309 • (810) 853-0050 • Fax (810) 853-0108 * sales@absoft.com 


Get Your Name “In Lights” 


li uve you ever though) about writing an article? Hie editorial 
Mail ,il MacTech Magazine would like to personally invite you to 
write for the ptihttcatiun, While writing an article is not difficult, il 
dcx-s lake a bit of time But, you get to share your knowledge 
with the community, see your names in lights*, and . you gel 
paid for your efforts’ 

To get started, you can download die MaeTcdi Writers Kit hum 
One of our online support areas Here you will find information on 
how to submit an ank le and it cutties with example, templates and 
style sheets. Fed free to e-mail us with questions. 

Cali. for Articies 

Many of you have askeil "what topics would we like to sceT Our 
Editor Board and Stiff lias \m tv Hied insight .is to what the magazine 
will cover in 195ft- Our goal at the magazine is to publish aitkks on 
diverse topics licit are suit* to keep our readers lnoth interested and 
wrfhmfonued throughout tlx* year. If you'd like to lx* pan of thus 
git nip, think alxxit w liat you know atxxii - that's wlai w ell lx* must 
interested in anti what ytxill lx* the I km at writing. As a guideline* 
you can think alxxii <>oe of the follow-mg issuer 

For example, topics that indude ankles rial leach debugging 
techniques and advocate good debugging tools This continues 
our theme alxHJt making software more reliable We will continue 


to talk about "cool* Apple technology such as QuickTime VK, 
QuickDraw \ <\ Dynamic languages; or as our Editor at-large Scott 
T Boyd said, software dial takes us out of the Stone Age.” 

‘There will lie tips t>n how to get your business on the Internet 
ami hosv business models are shaping up. More heavy-hilling 
deep technology articles will be included, such as ihe recent 
articles on CC.I development, C++ Exception Handling, etc We ll 
see continued coverage on the developments in Open Doc t as 
those in the industry decide what to make of this new software 
model 

MaeTCP is another area of importance, as more people get 
excited about providing Macintosh-quality software for Internet 
users, You will see additional (overage on Visual Programming 
You should also expect to see more on cross platform 
development And* even though it s a moving target, we will he 
covering Apple s next System Software release - Copland. 


far Jta-jflftrife 

Fm^tmmmen & Itfivtapen 



ifnf 


tech 


E-mail us with your idea and let’s talk. You never know, you might get your name “in lights"! 
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neoShare 


Client/Server 
Object Database Engine 


S 

i- 


Collaborative Computing 

NeoShare 0 * is a collaborative computing engine that objm-oriented developers use lo orate data intensive 
distributed applications, its dient/server architecture provides shared access to objects by multiple clients. Ibe 
server can co exist within a client application or operate m the context of a dedicated process. Clients can reside 
on the same machine as the server or on other machines across the network No other multi-user object database 
engine can match NeoSharc's feature set, impressive performance, incredibly small resource footprint, easy to use 
yet extensible programming interface and generous pricing structure 

Full Featured 

NeoShane consists of a set of C++ classes that fun her extends ihr leaturcs of NeoAccess™, our cross-platform 
object database engine, t aken together, NeoAccess and NeoShare form a feature nch groupware toolkit that 
addresses a complete sei of collaborative development requirements, including, object persistence, organizing, 
searching, transporting, sharing, locking, updating and concurrency control 

lhe collaborative: capabilities of NeoShare include; client/server connectivity, concurrency control, object locking, 
transactions, a hmdink facility, client-side etching to reduce network traffic and object overwrite detection These 
two professional quality devdopmem tools form the foundation upon which data intensive distributed 
applications air both 

Full Source Code 

Nco Logic has taken a frameworks approach with our object-oriented development tools. In much the same way that 
application frameworks ate used to construct the from-end of an application, NroAecess and NeoShare are the 
Irameworks you use to build your application's colLtbonmvc back end capabilities. Ihis allows you 10 focus on the 
value added poruon of llie application - the part that you know best 

As is the case with virtually all object Ira me works, the NeoShare Developer's Bundle comes complete wnh full 
source code So you have the security ol knowing that NeoShare technology is always at your fingertip* And our 
extensible architecture allows you lo evolve your toolkit into domain specific arras 


Easy lo Use 

Migrating your application source code from NcoAccess to NeoShare is easy because the programming interface oF 
both products is virtually identical This interface is designed around the concept of minimum visible complexity 
NeoShare naturally extends NeoAccess la add object sharing between clients and server Objects obtained from a 
server across the network by a client arc real C++ objects. You treat these objects as you would any other object 

NeoShare includes two concrete subclasses of the NeoAccess database class; a diem and a server Virtually all ihe 
complexities associated with sharing objects across a network have been hidden behind the interface to these 
dautlxLsc subclasses. In application code* a server daulusc object appears very much like u local database, except a 
server database also handles requests received from client applications. As clients request objects from a server, the 
server maintains a set of loc ks associated with those objects. When tfie state of an ohjeci in a server database 
changes, .ill clients holding locks on the object are automatically sent the object 1 * new state 

A client object also supports the same application programming inicifacc .is .1 local database Yei the implementation 
of ihis interface may involve sending a request to the renunc server. Tlx* server performs the requested operation 
and sends the results ol this operation back to the client The caller or the client da u base needn't be aware of ihe 
fact dial the database object on which it relies is in fact delegating oprruiions to a server database acrus; a network 
truer fact' The network is transparent to the application developer 

Affordable 


Tin* NetiShaie Developer's Bundle, which includes NeoAcom* sells for just $ 12W per developer with no runume 
her using fees It includes lull source code, sample applications, online dorrtmr (flat ton, and 30 days of online 
technical support Sue licensing, as well as educational and volume discounts are also available _ 

nco •logic u—. 

Professional quality object-oriented devefopment tools 



1450 Fourth St,® Suite 12® Berkeley ®CA°94710°(510) 524-5897° neofogic@neologic.com 









SYMANTEC 
TOP 10 


By Levi Brown, Symantec Cor}). 


SYMANTEC J 


This monthly column, 
written by Symantec's 
Technical Support 
Engineers, aims 
to provide you with 
technical information 
based on the use of 
Symantec products. 


Q: I scl my project's preferred and 
minimum memory partition sizes in 
the “Project Type* window, but 
when I build my application, the 
preferred and minimum memory 
partition sizes are always set to a 
different value. What Ls wrong? 

A: The project's resource file contains a 
SIZE resource that always overrides 
the value set under the Project, 
Options,.., “Project Type* window. 
To solve this problem, ripen the 
ProjcctNattie , rsrc resource 
file with Kesha fit and delete the 
SI EE resource, 

Q: I have heard of this program called 
Discipline that works with Macs Bug 
to provide a higher level of error 
checking. What does it do, and does 
it w f ork with the Symantec Debugger? 

A: Discipline is a system extension that 
works with MacsHug to check the 
arguments passed to Toolbox 
routines. Discipline is huill into 
Macs Bug 6.SJ12. To access it, you 
use the demd d izy. 


Our debugger has not been tester! thoroughly with 
Discipline. Therefore, it is possible that you may run into 
some Incompatibilities Discipline has a habit of revealing 
problems with many different programs including the 
Finder, which makes it difficult to use :ts a debugging tcx>l 

Q: In UNIX there is a collection of routines, declared in 
cursea . h that can be used to manipulate the cursor in a 
console like display. In my Symantec C++ Hi) project using 
the cnasole window how can I achieve similar results? 


A: Most of the functionality of the console window is declared 
in console . h. I lere Is an example of how to move the 
cursor to a specific point, and clear everything in the 
window from that point down, 

I include <stdio.h> 
fine*Tilde {console .li} 

oath() 

I 

int !, rh» mart ** 12. cols “ AO: 

consoie.aptluns.mouji * rows: 
con0ol«^«ptiotiN.Tirol n * cols: 
rrihomt stdoyt ): 
crsiij(rftottr*( C NOECHO, sUiuut ); 

// Sci mwktoCLMC M HO, «i 
// godur doesn't more the 
il ciiisor. 

fot{ 1-0; i<roY0 # colt; i++ ) 
fmteharf h 
rgoroxyt 5* 3, stdom ): 
eh ” getchflTt): 
rclooftf Fitdout ): 
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You’ve spent 

enough 

time in 
development. 

Don’t let your 
installer keep 
you from going 

golden 


De*!lnfillon 


\<s Q LHar Ipetiflt-iJ ftthler 
Q, liter fperffled Bisk 
Q Martup PHk 

D Dettiep 

Qj Relit** Apple M 1 * 1*14 I tiMin | 
S fit Hue Caitlrol PDiirl* 
liB Ac Hup tMpmloni 

f%) n mi up tanU 
JJD flftuip hvfutncti 
C$3 nr tli*e Utrlup iremi 
L^} At Hue % |t I pm raider 



Just because your 
software is done doesn’t 
mean your work is. You 
still have to write an 
installer. And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems’ proven 
installation standard, 
Stufllt InstallerMaker,'" 
you can have your 
PowerMac* or tiSOxO 
product ready to ship 
literally within minutes, 
and save money to boot. 

Stuffl L InstallerMaker 
uses our advanced 
compression technology 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit, Its menu- 
driven interface is so 
easy-to-use that even 
your VP of Sales could 
prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 

scriptability, 
and 

expanded 
localization, 
including German, 
French, and Japanese. 

To receive a free, 
fully-working copy of 
Stufflt InstallerMaker, 
call our licensing 
department today at 
(408) 7lil-(i200. 



«IUM 

CA 16071 Par IfflJttJI 
tfJMilt Ihum 



Q: Ym using the Tool Box call GetPictureQ and 1 want to 
clean up the memory sifter 1 ant done with the picture. How 
do 1 do that? 

A: Pass the handle that Get PictureO returns in 
ReleaseResourcet). Do not call 
D i Bposellandle {) on a handle to a resource or you 
may corrupt the resource map 

Q: When l try' to use the QuickDraw global variables in my 
Symantec C++ H.u project 1 get undefined symbol errors. 
I’ve used the same global* many times Ivfore using 7,0 and 
it worked just fine. What i.s happening here? 

A: With the introduction of Apple's Universal Headers, access to 
the QuickDraw global# changed. Your 7.0 project was 
probably referring to the QuickDraw global# in die “old" style 
and using Oh- original header files, not the l 'niversal Headers. 
You will need io access the QuickDraw gk dials through the 
qd struct* defined in Quickd raw. h . i.e.: 

CopyR&n(thePort >vlsRgn, thePort->clipRgn)s 
would become 

CopyRgntcjd.theport ->visRgn. qd.thePort >clipRgn): 

Q: 1 have a large H O project with many files and 1 frequently 
use the Find.,, command under the Search menu. Every 
time t use ti I have to set up the find parameters each time. 
Is there a way to net default searc h parameters? 

A: Yes! In your Symantec C++ folder there is a folder called 
(Scripts), inside which y«m will find a compiled script 
called Startup: 

tall application “Symantec Project Manager* 

Sac ihe default search state. 
set user search atari* to 
I wrap around : t rite* "* 
i jyiore ratten rue. ** 
files to dcorrhionly sources, “• 
ejtrludc system:true. 1 
eat lode precompiled header: true! 
end teli 
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You can set the default parameters fur the find in the 
indexed list sJnnvn alxivc, 

Q: I get link ermrs with a class that has static data memlX-TS. 
Why Ls this? 


A: If you declare a class with static data members you need to 
initialize those data members in the glnlxd data space outside 
the class, so dial memory Ls allocated for them. If you do not 
initialize the static variables in global data spaa* outside the 
class then the compiler docs not have a location for the static 
data members in memt>ry, Thus, you get a link error when 
you attempt to access that variable. Example: 

clttRfl A 
t 

public; 

e tat if short t; 
ftStic char y: 

char c; 

1; 

shot : A: ;* ~ D; if Xmr Thesevariahle*sic irthialiicd 

char A :;y m '#* ! //mi***dc the class dnrbfftioft in 

// tinier to ailocatr memory for them 


Q: The following ctxle used to work (up through 8.0), but in 
8.0-1 it doesn't. Why? 

class A 

I 

friend claia B: 
public: 

AO: 

-AO: 

B *tklFriciid(lni Index); 

I: 

cleat It 
I 

nub tlet 

BO: 

-HO; 

ifit index; 

h 

1 get an error on line 7 “semicolon expected". If I put 
friend before H * GatFr lend (int index), it 
works. Is it a compiler bug* or is it a new' ANSI rule of 
some kind that I didn't know' about? 

A: A couple tilings arc happening here: 


First, the ctxle above compiled in previous versions due to 
a compiler bug. 8.0 1 corrects this error Basically, the 
syntax is wrong The class a has no idea what B is yet and 
thus the compiler complains. If you put a forward 
declaration, class B:, in front of the declaration of A 
this will compile fine. 

Second, the Statement f riend B *GatFriend(int 
indax) tells die compiler that Get Friend Is a friend 
function, and therefore has access to As protected and 


^ oUN % 
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LS OBJECT PASCAL Vi .0 


OPTIMIZING COMPILER FOR 68K 

and PowerMac 

ON 

COMPLETE PROGRAMMING 
ENVIRONMENT WITH OVER TOOMB 
OF TOOLS AND DOCUMENTATION 

on 

Source level debuggers 

On 

Visual interface generator 

On 

Source code generator 

Plus 

native porting kit for 
MACAPP 2.0! 

On¬ 
coming Soon! support for 
Symantec project 
Manager 8.0! 


Call or write for more info: 

1-800-252-6479 
1-703-689-9593 fax 
Language Systems Corp. 

100 Carpenter Dr. Sterling VA 20164 
http://www.langsys.com/langsys 
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MacForth Plus & ^ 
Power MacForth 


The Language of Innovation is now 
available native on the Power Macintosh. 


FEATURES 

■ Royalty Free Turnkey 
Compiler 

■ Text Editor 

■ Online Glossary Too) 

■ System 7 Compatibility 

■ 68020 Assembler 

■ 68881/2 Co-processor 
Support 


■ High Level Graphics 

■ Toolbox Support 

■ Extensive Documentation 

■ Reasonable Upgrades 

■ Optional Tools Disks 

■ MacForth Plus $199 

■ Power MacForth $199 





4701 Raratolph Road. Suilc 12 
Roefcv»He. MO 20852 

301-M4-0P6? oi 1-800-FORTH-OK fwtfe/sj 
lax: 301-7?tM675 Applet* CSI 


private mcmlxrnc The statement B *GeLFriend Cint 
index) tells the compiler lhai GetFriend is a member 
fiimiit>n of A, In Ixxih eases rhe F r i e nd class B dtx\s 
nothing mure than allow all members of B access to A ? s 
private and protected mcmljcnc 

Q: t lave muck 1 a floating window view in Visual Architect, but 
when 1 go to mutch it to a command, it does noi appear in 
the list of views to open, I lew do 1 open it? 


Next, attach the command to the menu or button. If 
attaching to a menu: choose Menus... from the Edit 
menu, select the menu, dick on Edit Menu Items, select 
the item and choose the command you created from the 
Command: popup menu. If attaching to a button: select 
the button in VA, get Pane Info from the Pane menu, 
open the Uiutton triangle and ehtxjse the command you 
crated from the Command: popup menu. 

Visual Architect will generate an empty function, 
Doc mdOpenMyF Window inside x CApp ,cp. Call 
OpenWind () from here. 

Note: Oiling from outside the CMyFloaningWindow 
requires that you have a pointer to the 
CMyFlo a ting Window object* You can find this 
declared as a global in x CApp * cp in the form: 

extern CAFlaatlnftWJndow *&CAFlrmtingWinduv; 

ff you wish to make the call to OpenWindQ from 
someplace other than x CApp. cp, you must redeclare It 
(as above) and //include CMyFloatingWindow*h 
in the file where you want to use* It 

Q: When 1 try to mn the Symantec Debugger it quits with an 
error that says, "DebugServicos cannot set trace bit/ How 
do I set the trace bit? I can’t find any options to set a trace 
bit in any of the project option debugging screens. 

A: Most likely, you are ninning a Pre-System 7.5 operating 
system. You will need to put the items that are in the Pre- 
System 7.5 Additions folder into your system folder. The 
Pre-System 7.5 Additions folder is found in the Apple 
Software folder on your Symantec C++ 8,0 CD-ROM* 

Bonus: 

Q: I'm porting my code from 7,0.x ro 8,0 and I get an 
"undefined symbol MBarHcight" when I iry to compile. 
Why do 1 get a linker error? 


A: When you make a floating window' view, VA derives a class 
from CFloatDirector; we will t all it 
CMyF 1 oa t i ugWi ndow, You need to call OpenWind () 
to make i\w window appear (ShowWiridf) only undoes a 
HideWind{)). Hie easiest way is to call it from within 
CMyFloat ingWindow; ; MakeNewWindowf ), right 
after the object is created; the window will appear 
immediately upon bunch. To have it open from a command 
fi e. menu or button), create the command by choosing 
Commands*., from the Edit menu in VA. Enter die name 
for your command teg emdOpenHyFWindow), choose 
Cflpp from the In Class: popup menu and choose Call 
from the Do: popup menu. 


A: With the introduction of Apple’s Universal Headers you cm no 
longer access the variable MBarHeight directly. You will 
need to include l.owMem. h and use LMGeiMBax Height (), 
and LMSetMBarHei ght (), to access menu har height. 
Access to other tow memory variables lias Ixxxt dianged in 
simitar ways, so ifs a good idea to took in LowMenuh if 
you plan on using low memory variables 


Special Thanks To: 

Cilenn Austin, Mark Baldwin, Craig Conner, Rick Hartmann, 
Michael Hopkins, Steve Howard, Noah Uehcrman, Andy 
McFarland, Chris Prinos, and Kevin Quail. 
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neoAccess 


Cross-Platform Object 
Database Engine 


2 


Full Featured 

Now you nan embed the power of a full-featured object-oriented database engine into your Mae in tosh Windows, 
Unix ami DOS based applications No other object database engine can match NeoAcccss's impressive feature set, 
including Blobs, pan lisLs, iterators* swtzzlcrs, temporary objects, multiple indices on a class, inverted indices. 


stored queries, schema evolution, a powerful relational query mechanism, a streamshased l/o model and incredible 


|Mnfonu;mcc 

High Performance 

Jiuemally, NeoAccess uses c Mended binary trees and binary search 
algorithms to achieve optdually short access times Its automatic 
query optimizer ensures that queries always use the lastest access 
path to objects. And indices are dynamically combined, collapsed 
and compressed to keep access limes to an absolute minimum as 
1 lie contents of a database changes NcuAccess’s object caching 
IxHtsis performance by keeping objects in memory even after being 
disposed of by the application Your application's memory- sue is 
reduced because only those objects of immediate interest need to be 


Random Access 



in memory at any one time, not the entire lUe- a * 

_ __ _ _ - Oc^po* *pmibw 

Full Source Cade 

We've taken a frameworks approach toward object persistence and database technology In much the same way that 
application frameworks are used to construct the front-end ot an application, NcoAcccss Is the framework you use 
10 build your application's back-end As is the case with virtually all object frameworks, the NeoAccess Developer's 
Toolkit comes complete with fuff source code, for all major application frameworks including Met rowerks 1 
PowrrPbm, Symantec*® THINK C lass library and Apple MacApp on the Macintosh and Microsoft** 
Foundation Classes. Inmark's zApp and Borland’s ObjectW indows in Intel based environments- It can even be 
used without a framework or in one that you've designed. 

Easy to Us# 

The programming interface is designed around the concept of minimum visible complexity Application-specific 
objects inherit persistence properties from a NeoAccess base class These objects are organized in the database 
primarily by class Rut NcoAcccss also knows how classes arc related So multiple classes can be searched in a single 
operation And of course objects of any particular class can be organized using multiple indices. NeoAccess is 
unique in I hat u allows objects to be located based on abstract selection criteria or based on their relationship to 
oilier objects There s literally no database adminisLUion to deal with - NeoAccess takes care of all the details. 
NcoAcccss also includes a Blob mechanism which allows bee-form variable length data to he stored in databases 
with the same case as fixed-length objects NeoAccess even includes a powerlul set ol keyed iterators for traversing 
indices and part lists. Keyed iterators have the unique ability to iterate over only those objects in a set that match a 
given selection criteria. Your users will appreciate NeoAccess because databases are completely self-contained in a 
single document file So users can treat a database lilc as they would any other document. 


Proven 


NeoAccess has been commercially available since }992 Thousands of commercial and tn house applications based 
on NeoAccess technology have already been deployed NcoAcccss can help your organization deliver powerful 
products 111 a mure timely fashion than you ever imagined possible 


Affordable 


NcoAcccss 1 ® l*cst feature is its price The NcoAcccss Developers Toolkit sells for just $74<? per developer with 
absolutely no runtime licensing fees h includes fuff smi/t r code numerous sample applications. >00 pages of 
documental ion. and ^0 days of technical support St) whai are you waiting f« r7 


2 

1 - 





Professional quality object-oriented development tools 

1450 Fourth St. o Suite 12c Berkeley c: CAo9471Q& (510) 524-5897 o noologic@neologic.com 
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PASCAL 

ACTIVISTS 


By Brian Arnold and Gay McCarthy 


MacApp Pascal Rides Again 


Volunteers convert 
MacApp Pascal to generate 
native PowerPC code 


In 1992, Apple stunned Macintosh 
developers by announcing that ii was 
dropping MPW Pascal support from Us 
compiler suite and from MacApp, their 
premier application framework. This 
was a shock, given that Apple had lieen 
advising developers for years to 
program in Object Pascal with MacApp 
for maximum compatibility with future 
technology. 

MacApp developers split into two 
camps: those able to make the arduous 
transition to (>+, and those who could 
not justify the expense or were 
unwilling to abandon Object Pascal. 
The latter group faced an uncertain 
future, and hopes of purling existing 
MacApp applications to run native on 
the new platform were slim. 

Before the fateful announcement, 
Apple and Language Systems had Ixren 
collaborating on the next generation of 
Pascal compilers for the RISC-based 
Macintosh. That project, however was 
ultimately scrapped when Apple 
decided to drop multi language support 
from its HIS C compiler architecture. In 


December of 1993* development of LS Object Pascal begun 
again, this lime using source code from Apple's MPW Pascal 
compiler as the base. It was a long and difficult task to merge 
the aging MPW Pascal source code with Language System's 
FORTRAN technology and update it for the PowerMacintosh. 

In May of 1994, the first native Pascal sample program was 
shown to an enthusiastic crowd of Pascal supporters at the 
World Wide Developers' Conference. Shortly after, a grass-roots 
cooperative of Pascal MacApp developers was formed Co 
investigate the possibility of porting MacApp native with the 
language Systems compiler. The MacApp2PPC co-op (as it lias 
come to lx- known) was organized by Brian .Arnold of Lamina 
Decision Systems. This group of volunteers proceeded to 
accomplish what the corporations could not. 

Over the next several months, contributors on three 
continents Ix-gan the lengthy process of converting the entire 
Ixxly of MacApp 2,0.1 source axle in October, an FTP site and 
Web page were operational with a preliminary version of the 
scripts and documentation (see below), in November, key 
changes to the compiler's runtime architecture were 
implemented to satisfy requirements of the group. By 
December 1994, all of the converted source axle was compiling 
successfully with Language Systems 1 beta LS Object Pascal 
compiler. Only runtime Issues remained, 

In February, the target release date of May 1995 was set to 
coincide with the Worldwide Developer Conference in San Jose, 
California. Pinal technical issues were addressed during a 48 
hour “Hack Session' 1 on March 17-19 in nearby Menlo Park. 
Language Systems sent two compiler engineers with Power 
Macintosh CPUs to aid the effort. 

The Hack Session was a success. Participants (some of 
them operating remotely) included: Musahiro Alx\ Brian Arnold, 
Colleen Bar!on. Per Bergland, Greg Branehe Larry Hamel, 
Steven I lopkins, Eric Jackson, David Johnston, Steve Lavagnino, 


Brian Arnold and G tty McCarthy - Brian Arnold, Director of Software Development at lumina Decision Systems, us an 
,m lent supporter of OpenDnc anti MacApp 3 3* but hm company badly needed PowerPC native versions of legacy Objal 
Pascal MacApp2 axle, Guy McCarthy is President and CEO of language Systems Corp. 
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Tools Plus 2.6 

Tools Plus gives you the routines you need to create 
a professional looking user interlace. 

Then we make it work* IPs that simple. 


^CfKfeVVjrrinr */ C/C++ ✓ P.mrfPC 

V* Symantec ✓tacit i^OHI M 

■ Over T7D hjgl^owmM *m jihJ kuypl routine that ouuvruff ami oihantu: 
uvenr handling, windows., rhe Ux>\ bar, lltiatinf- palate, OJfSUrs huljnns 
picture- buHoivs, m mil bin. m^ms (jKilMbwiv Hterarchieot >incl pop-up V 
M Ikjjccs, fid<fe, Edii menu, clipboard. Dynamic AU*rb, and nnHc.. 

* Easy lo learn and e.rty it i u^- • h ir novice, Inier median.' and 

advanced programmers 

* Kim 1*1M; nmlv little memory ** disk space 

* Safer tbm tmdbo* fiHlfims , 

* Nn royalties | | 


* Subslanfin! cptfe reduction 

* Dramatic orates impUficatinci 
» Significantly less ddxjflgfnft 
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Cheryl Lins, Kun Schtnuckcr, anti Uirrv Tesler. Although the 
first native execution of a complete MacApp application was 
still weeks away, important technical issues, such as exception 
handling, were resolved. In addition, new technology such as 
floating palettes and other enhancements were merged into the 
Pascal framework. 

In the weeks following rhe Hack Session, the co-op 
mounted an incredible effort to gel PowerPC native MacApp 
2,0.1 up to kda quality in time for the Developer Conference. 
Support for the Metrowerks Pascal compiler was added. 
Several key managers at Apple joined in and arranged a 
distribution license so that Language Systems and Metrowerks 
could include the PowerPC native MacApp 2.0.1 on their CDs. 
(Special thanks to Kurt Sdimucker for rallying this effort!) lire 
first developer release ol MacApp2PPC shipped on (axleWarrior 
DR6 in May. An improved version shipped on DR7. but owing 
to a CD pressing glitch, the project files and documentation are 
wrong; the correct material is available online (see below). 

About a dozen developers have already partially or 
completely ported their applications to PowerPC, and a few of 
them have already started shipping their native applications. 
Brian Arnold ported Iris own application, Analytica™, in under 
two weeks, anti expects to ship by the end of the year. 

It is hoped dial by January 1996, two versions will be 
ready: the final, stable MacApp2PPC, and a developer release of 


an improved version. Mac Tech hopes to report further details 
in upcoming issues. In the mean time, developers who have VS 
Pascal can use the nethome release of MacApp2PPC Por more 
information see the MucApp2PPC web pages at; 

http://www.lumina.comyarnold/MacApp2PPC.html 

Or, for anonymous ftp: 

ftp;//ftp.rahul.net/ftp/pub/amold/macapp2ppc. 

lb get on the mailing list, write to: 

arnold@lunrtina.com W 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

product info@xpIain .com 
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FREE INSTALLER! 

To: Mac Developers & Product Managers 

From: MindVision (Creators of Stacker for Macintosh) 

Subject: Free Copy of DEVELOPER VISE 3.0 

Message: We've got a great new installer for you. 
Here's your chance to try it for free. 

No risk, no obligation, no hassle. 

Call today, don't delay! 






.e& 

v 





Cal (402) 477-3269 


IF YOU PREFER, USE E-MAIL. APPLELINK. AOL: MINDVISION * COMPUSERVE 70253.1437 



Join ihe growing list of companies who use our VLNK redmobgy: Adobe, Appfc, CE Software, Clans, 
CompuServe, PduiPoim, MacmMcdia, Radius, Suit Electronics, Symantec* WordPerfect, and many more. 


MindVision Software 840 South 30ih St,, Suite C, Lincoln, Nebraska 68510 
Voice: (402) 477-3269 Fax: (402) 477-1395 AppleLink, AOL: MindVision 

C 1992-94 MndVtMc m Software All Hgtis ItsmwI Ilewkq*T VISK r. j li*hmnk c4MmtlVbjon 8aftwwv 































































CRABB'S 

APPLE 



Visually Speaking 


Ids November, 1995. Do you know 
where your Mac development efforts are 
heading? Will they be linked, arm in 
arm, with Metrowerks, Symantec, and 
Apple, or will you set-off in the 
direction of one of I he Mac's ihird party 
niche tools companies, like Main Event, 
Pictorius, MainStay, QKS, or Digitool? 
Maybe you're even making the move to 
diem /server development and arc 
hunkering down with Oracle, 4th 
Dimension, Sybase, or even Pile maker 
Pro 3 0 (relational) and the FM Pro 
Server. And how much of your efforts 
are to develop software for both the 
Mac: and Windows 95? 

Visual Basic 4*0 for the M ac? 

No matter what direction your Mac 
development efforts will take you. 
however, they won't take you to 
Microsoft's Visual Basic 4.0. MS has said 
M no way” Lo porting VR to Lhc Mac, dins 
adding yet another brick to the wall 
isolating you from potential customers, 
Customers who might buy your 
Mac products for their Mac ghettos if 
they could somehow interoperate your 
Mac apps effectively with their huge 
installed base of Windows products, 
most of which are driven by OLE, 

Customers you might have reached 
a link. 1 faster if only y<>ti\I 1 1 ad the aid of 
VB 4.0 for the Mac to prototype and 


develop your Mac apps to live and work in a Windows world, 
But Microsoft says 'no way.” They don't want Mac 
developers porting their apps Lo Windows. They want Mae 
developers to dump the Mac and develop directly for the 32 bit 
Aid of Win95 and NT. 

The Importance of GLE and VB 

No matter how little you think of OLE 2.1), it's not going to go 
away just because Open Doc is a better SOM implementation. 
And Visual Basic 4,0 is the raison d'trc of OLE 2,0, VR 4,0 lives 
and breathes OLE. it can create every kind of OLE server and 
container, including in-process servers. 

With VR 4.0, die OCX standard has arrived with a flourish* 
VBX controls are automatically converted to OCX controls. The 
OCX language dialect is now VB and the runtime engine is 
shared by all MS Office 95 applications that use VB. And every 
third party addon module to Office 95. 

You cannot, however, create OCX controls in VB, but you’d 
buy Borland's Delphi 95 for that (yet another top Windows 
development tool that will not make it to the Mae). 

VB 4.0 is also the defacto scripting language for Windows 
95, even if MS has not pushed it as such (nor bundled it with 
the Win95 package as they should). As much as I love 
AppleScript and scripting on the Mac, VB 4.0 can do tilings that 
you can’t do nearly as well with AppleScript (even with 3rd 
party aids like Scripter and FaeeSpan), like creating commercial 
applications or OLE objects. Visual Basic 4,0, in short, is a big 
deal. And it's a bad deal for Mac developers (and customers) 
not to have it available for Macintosh. 

What’s Hot About VB 4.0? 

VB 4.0 is what I call a bridge language. It can be used by 
customers used to write application or system macros and 
scripts. It can be used by managers to create quickie apps. 


About Don Crabb - Don is a contributing editor and columnist for MacTech. Mac WEEK, MacUSEU, Mac Chicago, Mat Today. 
Wtn95User, ComputerUser, The Chicago Sun-Times Features Syndicate. The Springfield Union-Mews, PC Magazine, and about 
a million other publications Don welcomes comments at his Internet address: dcec@cs. udifcaga.edu. You can also check out 
his WWW Home page at http://www.cs.uehicago,edu/-decc/. 
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From idea to delivery... 



For 11 Years! 


International Datawares, Inc 
227S Trade Zone filvd 
San fosc * CA 95 HI 
(408)262-6660 
Fax: (408)262-8906 
Internet; idikds^aol.corn 


Complete 

Software 

Duplication 

Service 


800 - 222-6032 


FAST 


Sofhviirt' Du plit ilium 4- t U ROM 
Ldbrlini’ f Assembly 
Printing* ♦ I'urkj^in^ ♦ Shipping 
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all handled with top 

QUALITY ... $LK\ l( fi SPEED 


And it can he used by hard core application developers for 
everything front simple programs to advanced, enterprise-wide 
client/server applications thanks to its. different editions. 

Professional Edition 

The VB Professional Edition revolves around building 
Windows solutions quickly, making it a good fit for corporate 
IS departments. Coupled with [he Visual Basic for 
Applications language engine (common across many MS apps), 
you get core developers able to communicate easily, 
leveraging their skills. 


Enterprise Edition 

For large programming teams building big applications, 
Microsoft provides Visual Basic, Enterprise Edition. It enables 
teams to develop with Visual Basic via (he integrated Microsoft 
Vtsi ] a! Sou rceSa fe( h I *M) p roj ecta >ri e n ted versi< >n control system. 
The Enterprise Edition also features fast, direct access to remote 
client/server databases with the Remote Data Control. 

Tlie list of what the Enterprise Edition of VB can do is long 
and Impressive. Assuming you have at least half a brain, 
Microsoft expects that you can develop and debug a fully 
distributed application on a single workstation, then dynamically 
deploy it to network servers without much special help. 


You can partition your application into MS-standard 
reusable OLE business rule components, which makes it easy 
to reuse these components, across your net, with different 
development tools. You can also use the Remote Data control 
for high-speed access to ODBC data sources such as Microsoft 
SQL Server and ORACLE. You can also keep team projects on 
track by using the Visual SourceSafe version control system 
which works through MS's Solutions Frameworks 

Network for Distributed Services. 

In addition, and in no small measure. VB was designed Lo work 
with future Windows OS architectures (including NT), making it 
a very forgiving environment when MS pushes all of its Win95 
customers over to Win NT (Cairo) in 1997-98. The Enterprise 
Edition of VB lotus itself as the first second generation 
client/server tool that encourages developers to build scalable, 
maintainable, and widely reusable applications in a RAD 
environment. While that may be an exaggeration, the Enterprise 
Edition of VB is an important tool that will be widely used by 
our Windows chums. 

And wc have nothing like it for the Macintosh 

Numbers Don’t Lie 

And that, like everything else in the VB scenario is bad for us. 
More than two million copies of VB have been put into 
developers hands, making it one ol the most popular platform- 
specific tools you can buy for Windows. Name one Mac 
development tool that has sold two million copies. 

The Microsoft Way 

Bottom line, Microsoft is not about to expand VB s reach to 
help us. Instead, they're contented with keeping the Mac in its 
place,” as a senior MS official told me recently. He went on to 
say that there was w no chance at all," of VB being ported to the 
Mac, because MS was “not interested long Term in helping the 
Mac work with Windows*” In fact, since “wed rather that you 
guys just go away, why should we port our best devtoob to 
you," he concluded. 

Why. indeed? 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplain.com 
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By Jim Lloyd, jim@mekmgem.com 



The OpenDoc Development Framework 


A modern framework for 
OpenDoc development. 


Developing for OpenDoc 
The OpenDoc Development Framework 
(ODF) is a modern object-oriented 
framework for developing OpenDoc 
components for Macintosh and 32-bit 
Windows platforms. It significantly 
reduces the work required to create an 
OpenDoc component editor, especially 
if you're developing the part editor for 
both Macintosh and Windows. 

In this article, I’ll provide you with 
an overview of ODF. Because ODF is 
too large to address in one short article, 
Fm forced to condense and high light 
My goal is to provide you with an 
understanding of the problems ODF 
solves for you and how it solves them, 
and to give you a taste of what it is like 
to develop an OpenDoc component 
using ODK l assume some level of 
understanding of OpenDoc, but not 
much, so if this is vour first exposure to 
OpenDoc, l suggest you dive in anyway. 


I he better known frameworks include Apple's MacApp, 
Symantec's TCL. Metrowerks 1 FowerPlant, MacTech’s Sprocket, 
and Paul Dubois’ TransSkel. If you've used any of these 
frameworks, then you probably appreciate the time and 
aggravation they can save you by providing a solid foundation 
on which to build your application. These frameworks not only 
provide you w r ith code common to all Macintosh applications, 
they provide you with an architectural framework that makes it 
easier to design your own application, II all goes well, you 
simply Till in the colors and conned die dots," so to speak. 

The degree that “all goes well" depends on the framework 
you choose and your application's problem domain. The truth 
is, any framework is designed to work well with a specific 
range of application domains. If your application doesn't fit 
within dial range, then the framework will at best get in your 
way from time to time, and at worst be totally useless. You are 
not likely to have much success trying to write a 2K IN1T using 
TCI. or MacApp. I don't consider this to be a shortcoming of 
those frameworks; common sense dictates that one shouldn't 
assume a given tool is the right tool for all jobs, big and small. 
Of course, a framework shouldn't be a single tool; it should 
be a collection of tools that work well together If the 
framework is done well, some of these tools will be applicable 
to any problem domain. Modem frameworks are designed with 
this in mind. FowerPlant, for example, is well suited for both 
simple "dashboard' applications and large-scale applications 
that use multiple document types, and pieces of the framework 
can be used in programs that don't fit these domains. 


Why Another Framework? 

Macintosh developers today have their 
choice of several frameworks. Some of 


Why ODF? 

Why ODF Because even a flexible framework like FowerPlant 
isn't appropriate for all applications. First, developers need to 


Jim Lloyd — Jim Lloyd has worked on an eclectic range of programming projects over the last 16 years, including image 
processing of radar images, collection and analysis of kinesiology data, income tax preparation, relational database 
management using associate array processors, and natural speech recognition. Since 1992 he has focused on crass platform 
object-oriented frameworks, for the last year he has been a consultant to Apple Computer on the DDF project, and he 
recently accepted an offer to join Apple full time. Strange timing, since Jim is in the process of moving from Mountain View 
to a house he bought in San Francisco. Needless to say, Jim is already looking forward to the day that telecommuting at 128K 
or better becomes a reality.,.. You're welcome to contact him at jim^melongemxam, or jim_lloyd@powerialk.apple.com. 
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deliver I heir applications on multiple platforms, including 
Microsoft Windows. Second, GpenDoc introduces a new set of 
requirements that may he very difficult to fulfill unless the 
requirements are considered in the initial design of the 
framework. ODF addresses both of these issues, ODF is a 
modern framework designed to foe flexible and robust, to be 
cross-platform, and to provide complete support for GpenDoc. 

ODF is a cross-plat form framework because its AlMs 
abstract away the particulars of each operating systems specific 
data structures and Aids. ODF defines plaiform-independeni 
APIs, and implements these APIs on multiple operating 
systems. Developers who program lo the framework's Aids 
exclusively should foe able to move their applications lo every 
operating system supported by the framework by simply 
recompiling llieir code. ODF currently supports the Macintosh 
OS for both 68 & and PowerPC, and supports Microsoft 
Windows for its 32-hit operating systems, Windows 95 and 
Windows NT 

ODF includes a rich foundation of subsystems organized 
into two layers: the Foundation layer and the OS layer. 
Subsystems in the Foundation layer have no dependencies on 
die subsystems in the OS layer, and are generally useful for a 
very wide range of application domains. Subsystems in the OS 
layer provide operating system services such as files, resources, 
and graphics using platform-inclepcndcnt interfaces. 

On top of these two layers we acid a third layer, known as 
the Framework layer. The ODF Framework layer is specific to 
building Open Doc component editors, and is designed to solve 
the problems of that particular domain as well as possible, 
ODF provides full coverage of the Open Doc APIs, and correctly 
implements the human interface standards. If you use ODF to 
develop your Open Doc part, you'll need to do less work to 
make your part functional. You’ll also save yourself much of 
the additional effort required to make your part intemperate 
correctly with other parts, as well as the effort required in 
provide [l ie correct human interface behavior. 

An extra I benefit to using ODF is til at it provides so me of 
the !>csi sample code for Open Doc parts that you can find The 
ODF examples range from die minimalist ODFIiel t o part, 
which is our interpretation of "Hello World”, implemented as a 
pan, to ODFHraw, a cross-platform drawing part with floating 
palettes for drawing tools, pattern selection, and color selection. 
Of greater significance, ODFDraw is a robust container part for 
embedding other parts. ODFDraw has been the container of 
choice for OpenDtx* demonstrations for much of the last year 

Also Included among the ODF examples arc a bitmap pan, 
a dock pan, a movie part, a table part, and finally the iicepcr" 
part, which will play a big role in this article. 

Extending The Beeper's Functionality 

ODFBeeper is a simple button part that can play a sound 
resource, ODFBeeper, as delivered on previous releases of 
ODF, supports drag-and-drop so that you can change the sound 
that ts played bv dropping a sound file onto the button. In this 


article, well extend the Beeper part to also execute any 
compiled AppleScript dropped onto it. Thanks to Eric Jackson 
for coming up with this idea and drafting me to work on it with 
him at a recent ODF Coding Retreat, Hric and l did a quick 
hack so that the Beeper would execute scripts instead of 
playing a sound- It occurred to me later that with only a little 
more* effort, the Beeper could do either sounds or scripts. The 
code presented in this article does both, and uses an 
architecture that would make it easy to add other kinds of 
actions besides sounds and scripts. 

In order to see where we are going, let s first look at a 
screen snapshot of the final product; 
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This screen shot shows an ODFDraw document being used 
as a generic container. It contains two QDFBecper parts 
embedded inside it. Conveniently located nearby are some 
sound files and some compiled AppleScript files. The user can 
drag any of these files onto either of the buttons. Clicking on 
the button will perform the action corresponding to the last file 
dropped unto die button* Changes in the whole ckxument are 
persistent. The user can use the capabilities of the container 
application to rearrange the buttons, and can change the action 
of a button by dropping a new script or sound file onto the 
button. Saving the document saves all of the stale, so the 
buttons will be in the same locations and perform the same 
actions the next lime the document is opened. 

Developing A Part Editor 

Developing a pari with ODF is much like developing an 
application with an application framework like PowerPknr, TCL. 
or MacApp, You can use your favorite C++ programming tcxrfs, 
including Apple's, Metrowerks* and Symantec’s development 
environments, and other tools such as Object Master from AC1US 
and Die Debugger from Steve JasiL The ODF view system is still 
evolving, so currently there are no visual kxjIs far laying out your 
part’s views, but visual tools for ODF are under development. 
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for the purposes of this ankle, I started with the source 
for the ODFBeeper example part included with the l.Gd9 
release of ODK which was provided on the OpenDoc DR3 CD. 
If you have a source cotie disk subscription, the project and 
source for this extended example will lx_ i on your source code 
disk, but you'll still need the OpenDoc DR3 CD if ytxi want to 
further enhance the example. If you don't have a source code 
subscription, keep an eye out for the OpenDoc DR4 release; 
ODF I .(kill will on that CD and will include the extended 
ODFBeeper example. 

By the way, there's no way that MacTech could publish all 
the source code necessary for this sample (and you wouldn't 
want to try to type* it all in!), so I won't lx: showing complete 
source code listings in this article. Instead, 111 show the 
relevant snippets of code as they are discussed. In these 
snippets, 111 sometimes omit code not directly relevant to the 
discussion by replacing several lines of code with a single line 
containing an ellipsis and optionally a comment, like this: 

~ // irrelevant Muff nmitlrd 

ODF parts can lx developed for either PowerPC tx 68K using 
several different environments. For this article 1 used the 
PowerPC compiler in the CW6 release of Metrowerks 
QxleWarrior Gold and haven't yet tested the pan with other 
environments, but you can expect the part to be huildable with 
all supported development environments on the DR4 CD. The 
following is a snapshot of the ODFBeeper CodeWamor project: 
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The ODFBeeper example uses four source files. 
BeeperFart.cpp implements the classes CBeeperPart and 
CReeperFrame, which are subclasses of the ODF classes 
FW_CPart and FW_CFrame respectively. BeeperSel.epp 
implements the CBeeperSelec tiort class, which is a subclass 
of the ODF class FW_CS el fiction. Actions,epp implements 
the classes CAction, CSoundAction, and CScriptAction, 
aU c»f which are completely specific to ODFBeeper; ODF itself 
knows noil ling about actions. SOHBeeper. epp contains the 
C++ bindings for the required SOM subclass of ODPart, which 
won't lx* discussed in this ankle. In addition, ODFBeeper uses 
the resource file Beeper Far L, rsrc that contains a typical 
assortment of icons, strings, etc. It won t lx* discussed further in 
this article either. 


I'll now pnxxtxl to describe the source code in the three 
source files Actions, epp, BeeperPari.epp, and 
BeeperSel.cpp, in that order. However, before discussing 
the Action classes, 1 think it would be worthwhile to panially 
discuss the CBeeperPart class. If you are familiar with the 
Model-View-Controller architecture from Smalltalk that has 
been adaptt d in various incarnations in most frameworks, then 
you can consider the Action classes to be the Model, 
CBeeperFrame to be the View, and CBeeperPart to be the 
Controller. Since the CBeeperPart is in control, it is 
worthwhile starting with its relationship to the Action classes. 


CBeeperPart 

Here Is a partial definition of the class CBeeperPart: 

r 1 iiys CAc lion; // forward dtxbratiun 

class FW_CLASS_ATTR CBeGpprPart : public FV_CParc 

public: 

- //contractors, methods inherited from FWLCJart 

ft - 

// New API 

// 

public: 

CArtiou* GetAcUotiU I return t Act Ion; i 

void SetAction(CAction* action): 

public: 

void DoActionO; 

//- 

// Data Members 

// 

|i r i viu c; 

CAeiion* fAction: 

U 


In ODF t.0d9, CBeeperPart had a single data member that 
was a handle to the sound resource to play when the button 
was clicked. Since we want our new pan to perform different 
kinds of actions, we've changed the data member to be a 
pointer to an abstract class CAction, Well use the Action 
abstraction to minimize the dependencies of CBeeperPart on 
I he details of implementing sound and script actions. 
CBeeperPart knows about the existence of abstract actions, and 
has a very simple protocol for actions which include the ability 
to get anti set the current action, and to forward a request to 
apply the action to the current CAciion object. 


CAction 

U*t's now look at the definition of the abstract class 
CAction: 

clans FW_CM5.S_ATTH CAction 
t 

// - 

// Iniluli/jiion/l)attuafcm 

tl 

public: 

CActiontI: 
virtual -CAc tton(); 

U - 

// Action pmttKul 
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Fast remote internetworking 
in a single box. 


E-mail 

Streamline communications 
with enterprise-wide E-mail. 


Shared Access to the Internet 

Your whole department or organization can connect to 
the Internet—full time or Just when you need to. 



► Telecommuting 

High speed access to 
the entire office network. 





Centralized Databases 

Access or update information 
from any point on your Wide Area 
Network. 


LcpmaftaultiT I SON 



^ Videoconferencing 

Close the gap between 
distant sites with LAN-to LAN 
vi deoconf e re n c i ng * 


CiftfcviflMjter* 

rntagratnt 

Interface* 


► Fast File Transfer 

Transfer files at speeds up to 
1,544Mbps 10 MB per minute. 


What makes the ExpressRouter the best choice for your Wide Area Network (WAN) needs? 

* Built-in WAN interfaces for Frame Relay * ISDN. Tl, and 56Kbps DDS. 

* Expandable architecture that supports up to 3 high speed WAN ports. 

* Builtnn support for AppleTalk, TCP/IP and Novell IPX LAN protocols, 

* Interoperability via PPP. 

* Support for SNMP and Telnet management standards. 

* Powerful, easy-to-use auto-dialer software designed for the Macintosh. 



Engage Communication, Inc . 

9053 Sequel Drive • Aptos. CA • 95003 

Tel: 408.688.1021 • Fax: 408.688.1421 • E-mail: sales@engage.com *WWW: www.engage.com 









BUILD UPDATERS 
WITHOUT PROGRAMMING! 


PatcliNorhs Pro 

PatchWorks Pm has many opt kms, but only one function: to 
create small, stand-alone Updater Applirai ions which field- 
upgrade your products to newer versions, Updaters can be 
freely and safely distributed online, since they arc only of use to 
end-users who've already purchased your software. 

UPDATERS ARE FAST, 

SAFE a EASY FOR END-USERS 

Your end-user just downloads and runs the Updater. The 
Updater prompts the user for the original software via a "Get 
File 14 dialog box {if not in the same folder as the Updater). 

When the user dicks the “Update'' button, the original software 
is updated immediately. 



UPDATERS ARE CREATED IN MINUTES! 

Why tic-up valuable programming time building updater 
applications? just fill in a dialog, and PatchWirks does the rest! 
Since [here's no coding or scripting, no bugs are introduced, 

* Works with apps, I Nils, cclcvs, fonts, drivers, etc. 

* Works on resource and/or data forks 

* Full support for PowerPC anti fat binaries 

* Updaters support multiple "old versions” 

* Preserves personalization data (name, .serial #, etc) 

* Customizable end-user interface 

* Updaters can execute custom COOK resources 

* Intelligent diflf-ing produces small Updaters 

* Distribution of Updaters is unrestricted and royalty-free! 

NOW AN INDUSTRY STANDARD 
AFTER FOUR YEARS ON THE MARKET 

PatchWorks Pro is used by Macintosh publisfiers such as: 

Apple Computer, Adobe Systems, MicroMind, Now Software, 
Symantec, W>nil\:rfcd, and many mote: Pricing begins at (195. 
Download a fully-fumTkmal trial version from our web site; 
iHipv/ww’w.bnxidGistsoft com", or call tisat (407) 241-0308, 


Bf owCg t Software Corp 

East 407-241-0304 Fax 407-241-3195 
West. 503-3174)429, Fax: 505-3174)430 
Net htm/Avww InracleM.snft.ctMn 
Email: com 


Broadcast 


// 

public: 

virtual void In t er uaH tfiMEnvl rorroeiit * ev, 
OQStorageU&lt* storage) - 0: 
virtual vald Externalizc(Environment" «v, 
ODStorageUnlt* iforagej * D; 
virtual void DoIt(j - 0; 

h 


Ai t inn objects assume a twostep initialization; they are 
created in a dcfauli state and then initialized from a storage unit 
with tile Internalize method They also know how to save 
themselves to a storage unit via the Externalize method, 
and to do their action via the Dolt method. In tills abstract 
base class, the three methods other than the constructor and 
destructor are pure virtual methods. Subclasses of CAction 
must provide a default constructor, a destructor, and 
implementations of the three* virtual methods Internalize, 
Externalize, and Dolt. 

CSoundActiou 

Let's now kx>k at I he implementation of the two Action 
subclasses First, the definition for the class CSoundAcl ion; 

sJaa* FW.CLASS.ATTIi CSmindArr I on : public CAction 
l 

ff -- 

// ImiuJt/JiHm/tlcsinKiKin 
H 

pub1ic: 

CSoundActlunO : 
virtual "CSoundActionfl ; 

static rv Boolean lainSioragef 

tavirtmaent* *v„ ODStorageUnit* storage); 

n -—- 

// Attain pfutotd 

n 

public; 

virtual void Tmorrni lire (Environment* ev. 

OIlSloi ogi'linll * storage): 
virtual vo!d Externalize(Environment* ev, 

ODStorageUnit* storage); 
virtual void DaltO: 

//--- 

if Privaie i mptemenuuun 
U 

prI vat e; 

void IrHfrrmllxeSound(Envi ronmefit* ev, 

GttttorageUolt* storage); 
void Internal IxuSoimdFi)etEnvi ronriwnt * ev, 

OOStoragoUnlr* uiuroge); 

Handle fSoundHandle; 

u 

ibis class is a simple iiupkineniation of the ebss CAction, 
so the instructor, destructor, and three methods Internalize, 
Externalize, and Dol t are dictated by the base class. 
CSoundAct ion add'' a puNR 1 stalk’ method Is InStorage, two 
implementation methods for internalizing from specific sound 
formats, anti a data member for storing a sound handle. Lei’s 
look at the definitions of the methixLs of this class, lyegtnning wit 
(hi 1 implementation of tlic Internalize method inherited from 
CAntlon: 


CSouiulAciKMi Jiiicnuti/A 1 

void CSoutidAction;: Internal IxetBnvI ronaent 1 ev. 


40 


Tm nm vDnt l )evfujj’mhmt Framework 


MacTechMagazine » November 1995 


























































I 


QDStorafteUnit* storage) 


SOLID SOLUTIOIU FOR 
ELECTRONIC DISTRIBUTION 


FW_Booleari internal 1 *cd ■ FALSE: 

if (storage->Exists(ev» 

kODPropCo ft tents, kSaumlScraplUrid* 0)) 

f 

// Mac 'sml h in Strap 

storage >Focus(ev. 

k0DFrapGontonts« 
kODPosUmJef irted, 
kSoundScrapKind, 

0 * 

kGDPosUndefined): 

TaternslU»SQund(ev, storage): 

I 

else if (storage >I*|nt*{ev f 

kODPraptlontrnt r *. kSonndFileKind, 0 )} 

I 

// Mac sound file 
storage’>Focus(ev. 

kODFropCon tents* 
kODPonfitide fined * 
kHFSFIsvorTypft, 

G, 

kODPosUnde fined): 

InternaliseSoundFiie(ev, turn ago): 

1 

\ 


This code examines tin- storage unit fur die existence of 
either a sound resource (OSType f snd *) or a sound file 
(OSType 'sfil'k if either is found, the code houses the 
storage unit and then calls one of the two private member 
functions for reading the specific data type. 

By die way, the constants kSoundScrapKInd, 
kSoundFilcKind, and kHFSFlavorType are strings defined 
in the header file Beeper!)tf.h using a naming convention agreed 
upon by the OpenDoc implementors (Apple, IBM, and Novell): 

#define UJfSFlavorTypr "Apple:OSType:Sccap:hfs 11 
Jdefine kSoundScirapKim] "Apple!: OSType: Strap: and * 
fdefine kSoundFileKlnd "Apple:OSType:FtlrType:sfil" 


If Internalize detects a sound resource in the scrap, it calls 
the method Internal 1 zeSound: 


CSoutMtAcUoji: :Td tcmaliztSo und 

void rcSoundAction :: InternalizeSound f Jinvl runmem * ev, 
ODStorageUnit* storage) 

i 

// Assume the storage unit is already louistd 

unsigned lung adze “ ulor.j&G >Gpf.Size{ev): 
if (size > 0) 

I 

FW CA^quireTemporarySystenilandlf handle U 1*6); 

FW CByteArray byteArray; 

st a rage->U *t Value lev. size. byteArtayh 

by IgA tray. Copy Buffer (handle. GetFoirttecO , size); 

fSoundUandlc *■ hand le . Or Plat forinHandleO: 

handle.Orphan 0: 

I 


Internal izeSound assumes the entire content of the 
property value is a sound resource. It allocates a handle of the 
appropriate size and then reads the data into the handle. 
Finally, it stores the handle in the fSoundHandle field, 
hooking at the axle, we see that a little more is going on here, 
which is worth explaining in some detail. 


Broadcast 

Broadcast is a highly secure, patent-pending system for safely 
distributing "tockaf software online, or on CD-ROM* 'Hits 
cutting-edge technology was developed by the same 
engineering team behind Patch'Works— our tool for creating 
online updaters that's become an industry standard used by 
clients like Apple Computer, Adobe Systems, MicroMind, Mow 

Software, 


Symantec, 

and 



BROADCAST IS EASY 
FOR YOU AND YOUR CUSTOMERS 

In seconds. Broadcast securely locks your product into an 
Unlockcr application iliac can lx; safely distributed to the 
public, lb buy your product, customers simply run the 
Unlocker— then cither call you, or complete an onscreen order 
form that’s emailed or faxed to you with a unique “control 
number 31 (and encrypted credit cant data). 

Your staff processes the credit card, registers your new user; 
and provides your customer with a password based upon the 
comm! number, lb unlock your software, the customer enters 
this password In the Unltxkcr. 

BROADCAST IS INEXPENSIVE 

We aren't resellers or distributors. Customers buy directly from 
you, and we take no percentage of your sales— just a small fee 
per transaction. In fact, Broadcast is distributed for free* Wre 
betting you’ll quickly use the free password points that come 
with Broadcast, and purchase more as your sales soar. 

Well even help attract customers by advertising your products 
for free on our "Software Unboxed" internet mall. 

GET THE WHOLE STORY 

We invite you to learn more by visiting our internet web site at 
M http://wwwbro:idcastsoft r ainr, and download your free 
Broadcast Starter Kit, or email us- * In fo@broadcastsoft .corn" 


Hast 


Broadcast Software Corp 

East: 407-241 -0308, Fax: 407-241-3195 
West: 505-317-0429, Fax: 505-51 7 M5'I 
Mcr: In ipvAvwixoatkastsoft.con i 
Email: Lnftj@bmadcasL'toft,com 
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Presenting the extra-strength text editor. 





If you thought previous versions of QUED/M 
were powerful wait uotiJ you program with 
QUED/M 17 * loaded with these new pm- 
relieving features: 

Integrated support for THINK Project 
Manager 1 * 6,0 & ZO 

THINK 1 " debugger support 
CodeWamo^ ,,, support (now it's 
easier than ever to program for the 
Power Macintosh®!) 

& MPW ToolServer J support 
PopUpFuncs" support 
Frontier 1- Do Script support 

For quick relief, call 
800-309-0355 today. 


Of course* QUED/M 27 still has all the features 
that make it easier to use than any other text editor 

& Macro I anguage lets you automate 
tedious tasks 

Search and Replace through multiple 
unopened files and using CRFP 
metacharacters 

File comparisons using GNU Dlff 
** Unlimited undos and redos 

10 Clipboards that can be edited, saved, 
and printed 

Customizable menu keys 
Text folding 

Display text as ASCII cedes 
Plus many more features! 






Get even more relief: Try QUED/M 2.7 now for just $69! You'll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


mrnm s * n*w* 4 ***■» imxftK tk. AM *kt 

rrt IWlHitifrlf irptifUlJ Hlf llfcff irffl UH ij^tr 
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To allocate the handle, the code uses an instance of the class 
FW CAcquireTempora rySystem!landle, which is a resource 
acquisition helper object that allocates a Temporary" handle The 
handle is considered to lx* temporary because unless instructed 
otherwise* the handle will Ik- disposed when the helper object 
goes out of scope. On the Macintosh, the constructor of 
FW_CAequ i reTempurarySystemHandle will allocate a 
handle in Muliitmder temporary memory (throwing an exception 
if the allocation fails), and darn lock ihe handle down In memory . 
On other platforms, it d<x*s something equivalent. 

Hie KW_t)Acqu i reTemporatySysteisHandle destructor 
will unkxk ihe object, and optionally dispose the handle. Tlie 
default behavior is to dispose die I Kindle, bui aiding the Orphan 
nxlluxl instructs the helper object to not dispose the handle. This 
may seem a little involved, Nit it is a very convenient idiom for 
alkxalion of nesextrces (like memory) that must lx disposed if an 
exception is throw n before tlx* resource is completely initialized. 

In CSoundAetion:: TnternalizeSound, we ran assume 
that any of the three lino of axle starting with the call to the 
method Get Value and ending with the call to the method 
GetFlatfarmhand ie could throw an exception In actual fart, 
with the current implementations of these functions, only the 
GeL Value method could throw an exception, but in this case it 
hurts nothing to be conservative. 

ODF provides a range of utility functions and helper 


objects that make it possible to write portable axle that works 
with exceptions correctly* In the case of 
CSoundAction:: Internal lz*eSound i the advantages of 
the platform-independence of the helper objects 
FW_CAcquireTemporarySyutemHand1e and 

FW CBytcArray aren't fully realized because the function as 
a whole is making an assumption specific to the Macintosh: 
’and 1 resources exisi only on the Macintosh. With a little 
extra effort, it would lx* possible to create an abstraction for 
sound data that would work on Ixxli Macintosh and Windows. 
Such a class will likely make it into ODF someday; in the 
meantime* we leave it as an exercise for the reader 

let’s now look at the method i<i interna I i/.e a sound file: 


(.VHimlActiufi Jnrcrnjdj/tVmndlik 

void CSmmdAc i ion:: Interna 1izeSoimdFi letEcvftorment* ev, 

OUS1 0 fagcUnil* s1 0 rage) 
t 

U Skia|gr t nil slniuM alrtxh Ik Fno&nl on HFSRiYor 

unsigned long hfsSize “ storage X>iSIze(cv); 
if (hfiSln > 0) 
l 

// CfCi Ihe ItFS flavor 

IIFSFlavor hi s Int o; 

FW_CByteAr rsy by %©Ar r my; 

Stonge->G#tViIue(ev, sizeof fHFSFlavtir}, byteArray); 
bytMrray.CopyBuffer UhfnTnfo* sfr.cof (IIFSFIavor)): 

// Crate platform intfcpt-mlrni tile spec 

FW J*F11 eSpGclfleutinn flieSpM (hfsInfo.flleSpec); 
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Macintosh and 
a UNIX workstation. 
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The Mach 1 ”" operating system combines the high-level 
functionality of a networked UNIX workstation with 
Macintosh’s wide array of applications. 


Mach 1 * 1 is a Berkeley 
KSU UNIX INI; njriKiin 
the Classic to the Pdw? r 
Mucin tosh* including 
pDwcrBtKjks anti Puns) 

So in iiiidiUmi to nil of Lite 
casyUmsn ippUcatkxn 
that make Mac in tosh 
otteofiher most, 
able compute m around, 
yuilgpt M 

UNIX with prr* cmplivf* 
multi Bufking 

Mach™ 1 * strength 



Any NFS ttmr tutu lw uuml lu jcUh u MkhiIosIi 
IIok Ur-tre con ito:iss them by tkiulita dfcting 
ai tin Hut lotiil dull 


»lITCP4mswit‘ntiUwi 
on your network. 

The UNIX soElwan? 
development system 
Includes the GNU C and 
C++ compilers arid 
libraries to let you 
create now ajtfilicalinrut 
or tK>rt existing ones. 
The Motif toolkit artd 
suite of X clients anti 
X n I lent libraries make 
developing distributed 
applications a broessc 


\m in the way il m£lends the Mucintoah 
Operating Systom with UNIX networking 
and software development U*»l.s Hie 
Macmtosih/tJNTX integration is so strong 
tJmL you can even life Mae programs X 
utilities on UNIX data, and UNIX programs 
& utilities on Mur files 

Full mtorml juntocol support ensures 
fast, etisy client and server NFS, electronic 
itkiil, and Hie Lr.irtsfef totwreu the Mac and 


A 


And Tunnns high jierformance X Server 
lets you use your Macintosh or Power 
Mucintoah m an X terminal. 

Join the many satisfied users of proven, 
reliable Mach 7 * 1 UNIX, and start turning 
all of your Macs into open systems today! 

For more information, or to order 

call l^Oft^MACH-10. 

Internet: iiifo@TeDon.nnii 
hUp: //wwwaeiion-eom 


r TCRiAki * ^ nt: thvwtsvms in hTswuit 

r, 1 fclwl\ : HUfaWm TJ^Kinsv 

Tooon Inlofsystoms 1123 Chapala Street Santa Barbara. CA 93101 Tel: 805-963-6983 Fax: B05-962-8202 
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// Open (hr rrsunnv flic 

FW_CKeuuurceFile reoourccFHoff lleSpec); 

d Gel any <l,c, tin; firO sound r o p o r re 

const FW_ResourceType resourceType * *uud *: 

const FW Resourc«Id resourceld = l; 

Handle aotttid - : :GeUJndftesQurce(resourceType F 
roflourc^td): 

if (iound HUUT 

I 

// if succeeded, detach ilu handle and keep it 

: :DetachResource{sound); 

fSoundHAndie * sound: 

I 

else 

l 

U No viand fra Hirer kudrd throw An cm rpinin 

FV_TttROWlFW_XRestJurceNott‘ouud (teuourcePi le, 
rtiourcdd, 
resoorcetype)): 

J 

I 

i 

InternalizeSoundFile is similar to 
InternalizeSound, The difference is rK.it instead of getting 
the sound resource directly from the storage unit, it instead gets 
an HFN file specification from the storage unit. It then uses this 
file specification to open the (Be and grab the sound resource 
from the file The code here is a hit com pi tea led because 
sound files don't use fixed resource IDs, so die code must look 


for any sound resource, Unfortunately, this is a function that 
we don’t (yet!) provide in the Resources subsystem of ODF, so 
we have to resort to direct tails to the Macintosh toolbox 
resource manager. The good news is that ODF doesn't get in 
the way of doing this. In feet, it is still convenient to use an 
instance of the class FW_CResourceFi Is to open the file, 
since il wall assume responsibility for dosing the file when it 
goes out of scope. So, we use ODF to create and open the 
resource file, and then use the two toolbox calls 
Get 1 IndResource and DetachResource to get the sound 
resource from the file. Since we’ve taken direct responsibility 
for reading the resource, it is our responsibility to handle any 
errors, which we do by throwing the appropriate exception. 

By the way, a new feature already added since ODF 1.0d9 
will make it simpler to throw standard exceptions, instead of 
writing the above FW_THRQW statement, you could instead 
write something like this: 

rv.Fil IGnError t:: RccSt ri?r 01: 

We've seen how to iniemalixe sound resources, now lets 
see the rode to externalize them: 

(' Sound Act ion::txi tmdi/e 

void C Sound Act ion:: Extec null jtufEnv \ ronraom ■ r-v, 
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heti it comes to text editing h m you 
for a littke dhrine inter- 
Weil (fit hasn't arrived yei 
should be considering PAIGE. 

Whether yiai're developing Ik next "killer" inter¬ 
net application, building a custom publishing tool or 
adding advanced word processing to your CAD pro 
gram, you can't \pm llie quality of your text editor. 

With PAIGE you can create the most soptiis 
licated text features in the business, Including: 

■ Stylized Tfad 

• Text Wrapping 

■ Embedded Objects 

• Shapes & Containers 

• Virtual Memory 

•Style Sheet Support 

• Multilingual Capable 

• Portable C Code 

• Royally Free 

PAIGE Is written in portable C and uses no global 
variables, Machine specific code is minimized to 


cjisurtaconsistmiAPl 
for ailplatfomis— 
simplihingmulti- 
plndomncta-TQlopmcnL 
This strategy allows 


you to move your 
application toother 
platforms while main- 

To simplify die integration of PAIGE into Windows 
t lb-bit, 32-btt. ‘95 or NT) applications, our library 
ships as DLL’s and can lx: used as a custom control. 
Combined with the message based dtmi source code 


and simple introduction guide, PAIGE gets programmers 
up and miming quickly 

So why should jou buy HUGE? TIME. Programmer 
can’t afford to reinvent die wired wlren implementing 
advanced text feature witliin their applications. 

Join the hundreds of majursoftwarc publishers 
using PAIGE as their total text solution. For a complete 
technical and pricing summary, or to request our prod¬ 
uct demo, contod die DS1 sales depaitani today at 

800-527-6703 or 360-573-9155. 



Datal’ak Software Inc. 

9317 HE Hwy 99, « ■ Vancouver, »A 98665-#900 
Bus: 1360) 373-91 S3 • Fax: 1360) 573-9269 

Inter nr l: 76424.3027@compuserve.com 
w ww. It I e p o r I. com/- datap ak/daiap a k. h tm 1 
AppleLink: 1)0142 • AOL: DATAPAKI 
• CS: 76424.3027 


“Say, nice job brother John. Now could you make it a three column 
format with digital memos embedded in the text stream?” 


E 


ODStorageUnit 4 storage) 

// AsMiim; wc’rt focused un the correct property 
storage'>AddValue(ev, kSuundSrrapKind); 
if f fSosindHnndle* !“ NULL) 

I 

FW_CArqii I roLot kpdSy.'J' I ock (tSoutidHandle); 

PW JJKy teAr ray byteArray (*f SoundKandle * 

Fl'LCMeBory Manager:: 

GetSyeteaHand LeSize(f Sound Handle)}: 
storage-^SetValuefev, byteArmy); 

I 


External I xe simply adds a sound scrap property value, 
and then writes mu the .sound handle. Since the handle needs 


Here we simply lock the handle with a helper object and 
then use the toolbox function SndPlay to play it. What could 
Ik.* easier? 


CScriptAction 

The implementation of the class CScriptAction has a lot in 
common with the class CSoundAetiore Compiled scripts, like 
sounds, are stored in memory as relocatable blocks accessed 
via handles, and are stored on disk as resources in the resource 
fork. The code to internalize and externalize a compiled script 
is therefore similar to the code to internalize and externalize a sound 


to lx* locked in order to lx* written out, we take advantage of 
the FW_CAcquireLockedSystemHandle helper object to 
lock the object and assume responsibility for unlocking it. The 
rest of the code should lx* self explanatory. 

Finally, we round out our implementation of 
CSoundAct i on with the Doll method: 


OioundAction tXiU 

void CSoundAction::Dolt(} 

( 

if (fSoLmdflfimtl r* J- NULL) 

i 

FV^CAcquiteLoiki.'dSystemHandle iockCfSoundHandle); 
iiSodPlaymULL, (SndListHandle)fSoundHandle. TRUE); 

I 


resource. The only significant difference is in the implementation 
of Internal!sseScr i pr Ft le, so for the sake of brevity, well 
skip tlx* code for CScriptAction: :InternalIzeScripT and 
CScriptAction:; Externalize, 

CScriptAction: Inirmahzc&'ripiFite 

void CScr i|>f Arr ton:: Tntornnl i^oScrlpLfllefEnvirorittctiL* t*v* 
OliSiotugu-Unit" storage) 

I 

// Storage l foil shinild jJready tic housed un lIR&Fbvur 

unsigned Jong hfsSlie - storage >GetSiz$[cv): 

If (hfsSize > 0) 
l 

// Get the HFS favor 

HFSFlavor hfulnfu; 

FWJSByt v Array byteArray; 

mo rage >CetValue {ev, sistoof (HFSFUvor), byteArtayJ; 
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fryfr 
// W 


Tech 


byicArruy, CopyBuffer {AhfnTnfo, Rlzeof (EFSFlavar) J: 

// Make dir fik spec tfkatkm 

FW_CFileS(iecitic*tion flicSpte(hfsinfc.filcSpec); 

H Acquire an opened reauurec flk, 

// will be closed automatically 

FW (SfflfliirfjFUft renoureefileffileSpec); 

// Acquire an opened resource, 

// will Ik- rttetd mrtomatkally 

FVLCKesource ruaourcufreaouteeEile, 128, ^scpL 1 ); 

// Copy dir rest Hirer handle 

fSeriptHandle - FW CMetaoryHanager 11 

nopyKysTewHrtndiM resoiirrfc.GetHandleC)) i 

1 

1 

Compiled scripts are always stored with the Fixed ID 12K, 
This allows us to use live DDF resource subsystem to load the 
resource instead of reverting to the MacGS toolbox. This is 
done by simply creating a Instance of the Ftf_CResource 
class. This class loads the resource in its constructor, and 
releases the resource in iLs destructor. It is exception-safe, and 
works correctly on Ixtfh Macintosh and Windows. All we need 
io do to finish internalizing the script is to copy the resource 
handle and store H inside die fScriptHandle data member. 

The CSoundAction: ;DoIl method executes the script using 
the static method CScr iptArt Ion:: LoadAndExeaiteScript: 


C XnptAuiuti : Uul i 

vci i il CSc rIp L Ac t inn;: Jki f T () 

t 

if tl Script Handle 1* NULL) 

Lo pdAftdKxecuteScr i pt (f Sc r IptUand 1(*); 


C X ripiActlonnU KuiAndExtt mcScripi 

void CScHpt Action: iboartAnrlExecuteSetipt (Handle scriptData) 

I 

AEDese scriptDeuc: 

OSAID script ID. result ID; 

AEDesc scriptText: 

OSAError error; 

static Coaponen tins tones gConponent - 0; 
if (IgCosponcni) 

gCoeponcnl - OpenD p fnull Componentf 
kOS AComponetitTypf, 

kOSACene ricScriptingCoapunontSubiype); 

// khul the M_npi dau 

scriptDest.descriptorType * typeGSAGenerieStorage: 
scrIptltaftc.dstsRsmlle - scriptUsta; 
error ' : :GSAI,oad (gConponent. Ascrlptltese, 
kOSAJiodrNii 1 f, Aset i pt ID) : 

if (error — noErr) 

1 

// execute the compiled nript in the default cortlcxl 

error * ; :OSAF.xecute(^Component, 
flcrlptrD, kOSANullScript, 
kOSAModtNul 1, &recii 11TD ); 
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errors : :OSABispose{gCotnponetit. seriptID): 
error - ::QSADlspoge<gComponent, resultIDj; 

1 

1 


There's nol much to say about this code. 
LoadAndExcecuteScrlpt is lifted almost verbatim from 
IAUAC, pp. 10—16. I haven't bothered to address the fact that it 
just leLs errors fall on the floor unnoticed, though with the post 
3.0d9 additions to exception handling it will be a relatively easy 
task. All that is necessary is to sprinkle a few calls to 
FW_FailOnError(error), 

Tltat basically completes the description of the action classes. 
Observant readers will note that I’ve not yet described the two 
static methods IsInSlorage, one each for the classes 
CSoundAction and UScriptAction. Well get to that shortly. 
Let's move on to the implementation of the class CBeeperPart. 

CBeeperPart 

Earlier, we saw a partial class definition for 
CBeeperPart. At that time, we were interested in the 
protocol inherited from FW_CPart; we were only concerned 
with die protocol related to Actions. Now lliaL we're ready to 
talk alx>ut the part protocol, it might lx* worthwhile to see a 
complete definition for the class CBeeperPart: 

class FU_CLASS_ATTK CBeeperPart : public FW_CPart 
f 

public: 

static const ODValooTypc kPartKind: 

it -- 

if lnjtiaJijaiiofl/IX^mK.1 Urn 

if 

public: 

CBeeperPart(ODPart* odPart); 
virtual -CHpeperPart(): 

virtual void iuitiaiize{Environment * ev): 

ft -- 

// IlllKTItcJ AH 

// 

public: 

virtual FW_CFr r {inM* NowFowiit 1 [Rnv i roniucnt* ov, 

QOFrame* ctfPtaaie, 

repeataLion* pryuentutiem* 

FW^&doieati tromStorageJ; 

virtual void Internal!teContent(Environment* ev. 
ODStorageIJnit* storage, 

FW CClonelnfo* elranpTnfo): 

virtual void BxLeruul lEeConleni [Environment* ev, 

OUSturagoUnit* storage, 

FW_CCloneInfo 1 clomrinfo); 

ft - 

ft Ncft-APf 

ft 

public: 

CAcii'Oii* GeiActionO t return f Act ion; 1 
void SerActientCAction* action): 

public: 

void DoActionO: 

ff- - 

ft Data Members 

ft 

private 


CAction* fAction; 
J: 


Let's begin with the constructor and destructor of CBeeperPart: 


CBorpiaftui: iCBerperftut 

CBeeperPart:: CBeeperPart fODPart* odPart) : 

FW CParrtodFart.. CBeeperPart::kParrKind), 

Met Jon (NULL) 

( 

I 


CBeeperPart::-’CBeeperPart0 
I 

delere fArtiom 

1 


QkcptrPart:: -Ok-eptrPajt 


The constructor initializes the FW_CPart base class, and 
initializes the fAction field Lo NULL. The destructor simply 
deletes the object pointed to by fAction. Of course, the 
FW_CPart constructor does quite a bit of work; CBeeperPart 
inherits a lo( of delay 11 Ixdiuvior from its FW_CPart base class. Il 
Is Ixyond the scope of this article to go into the details of the class 
FWJIPart, but suffice it to say that ODF makes it pretty easy to 
create a new pan by overriding just a few methods, as we nt about 
lo sec. The next method is the Initialize meilnxi: 


CficrpcrParr: Inuyliw’ 

void CBceper i'i'ir i:: Ini l i£iI ijtt 1 (Knviruniipnl * ev) 

I 

FW„CPart;:lnitlaliE€fev): 


1 


ft —* Register our Procnuik>n 

dkcporSelectton "fillet r inn _ 

nr* dccpeBcloctlonlcv, this): 
Hegi i I** t Prifstn Ui i iottUv, kOOFBeepprP realm taticro* 
TRUE, selection); 


To initialize I lie CBeeperPart, we must first call the 
inherited method to Initialize the Base class Next, we create an 
instance of CBeeperSelecLion, which is a subclass of 
FW^CSelettion. Selection objects are used to designate the 
user's selection for data interchange via any of the interchange 
mechanisms: copy/paste, drag/drop, or linking. Finally, we 
register a presentation. Fans may have multiple presentations for 
displaying their data content. A classic example is a spreadsheet 
application that can display its data in a tabular array, liar chart, 
pie chan, etc. Bach presentation may have its own selection, so 
the selection object is owned by tlie presentation. 

CfSccpcrPjn. :NrwFrtfttc 

ra*i** CtJtepe rPftrt: :RewFrane (Navi ronoent 1 ev, 

OBFraae* traise, 

FW CPresentation* presentation. 

FW.Boolean storage) 

return now flBeeper Frame (ev, Frane. presentation, this): 


NewFrame is a factory method which will be called 
whenever the part needs a new display frame. If a part 
supports multiple presentations it would create different kinds 
of frames, but our Beeper part supports only one simple 
presentation and creates only one kind of frame. 
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fJHtTptTParE:: I ntemaJi/iS Lonl uni 

void CBeeperPar t: : later nail zeCQit tent (Environment *ev, 
OnSlora&cUntt * storages 
FW CCtonelnfO* cicmelnfo) 

J 

FW ASSERT(fAction — KtH*U: 

if (CScr i pT Act ion: : Tri! nStoragetev, ntnmgfi)) 
tArticm ” new CSv t Lj.itAc 11 on () i 

else if {CSoundAr;!iuti:; itiinStE)rage{ev, storage)) 
fAction " new CSoumlAttitmO; 

if (fAction !- NULL) 

fAction->In terna1ize(ev t storage); 


dictionary mapping known data interchange types to factory 
functions. However, for the purpose of this example, such an 
approach is dearly overkill 

Once an action instance is created, we initialize it from the 
storage unit using the Internalize virtual function, 


CBctpcrfan: ;i^LcmilLM.Ci«iicnt 

void CBeep^rParT : lExternalizeContent(Envirosii£iit *ev f 
OBStn rageIJn i r * storage. 

FVJX1 oneTnfu* <* Id tie Info) 

I 

// If any kind of property content exists,,. 

If (stoci|«->Ek«ta(ev» kODFropContents, kODNULL« 0)1 

storage ->Focus(ev, kODPtopContents, 

kODFoslIndenrted. kODNltl.L, 0, kQDPo&All): 
storage >Rcfaov<riev); 

I 

storage >AddFropyrty(ev, kGDPropContents); 
if (fAction !- NULL) 

fAction*>Externali 2 e(ev, storage); 


ExternalizeContent checks to see if any previous 
content exists in tile storage uniL, and if so, removes die old data. 
Ii then adds a content property, and delegates the task of 
externalizing to the Action object Ihis will result in a call to one 
of the two methods CSoundAction: :Externalize or 
CSoundAction;: Internalize, which we have already seen, 

CBcrpcrflart:: Do An ion 

void Cfici? per Fart: :DoActlon{) 

I 

if (fAction f- NULL) 
fActioti >Ik>lE 0 : 

1 

DoAction is ex ecu Led whenever the button is pressed via a 
mechanism that well discuss shortly, DoAction merely 
forwards the request to the current action object. 

(; IteepcrPiui:: Set Act n >n 

void CBoeperPart: rSetAction(CActiot) ’action) 
i 

Jf (action AS ,*r f I on! “f Act Ion) 

1 

delete f Ac lion; 
fAccion * action; 


I 


Internalize Con tent is called when the part is being 
initialized from storage. CBee per Part determines whether 
the storage contains a script or a sound, creates the 
appropriate action object, and then delegates to the action 
object. Here we finally see the purpose of the two static 
methods CScriptAci ion: : fsTnStorage and 
CSoundAction: : IslnStorage, These methods examine 
the storage unit to see if they contain the appropriate data ripe. 

This mechanism for creating an instance of the right action 
type based upon the contents of the storage unit is a bit 
simplistic. If we had many action kinds, it would become 
awkward, and a more extensible mechanism would Income 
desirable. One reasonable choice would be based upon a 


Set Act ion is used to change the action object It is called when 
a client of CBaeperPart wants to change the parts current 
action. Well see it used by the CBeeperSelection class. 

CBcepcrFramc 

ODF contains a class FW_CFraae which provides a rich 
definition of the Ixduvior of Open Doc frames. FW_CFrame 
inherits behavior from four mixin classes (FW_MEventnand ler t 
FW_MGadgetContainer, FW_MDragDroppable, and 
FW_Mldle), and has uU>ut 100 methods! Despite the size and 
apparent complexity of FVLCFtame, implementing a subclass is 
relatively easy; CRee per Frame overrides only five methods: 
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All the Source Code. 
THINK Reference 2j0. 
Working Applications. 
Full Documentation. 
Demos for Developers. 
And More!! 

"Wlten I designed THINK Reference, 1 cnvisktid endless 
databases at my MacTech has doubled the 

information that is |iis! a mouse tM away, " 

Damil IMmc, Formerly ofSymantec^ 
Author ; VIINK Refcrence2M 

"The 0) strike me as an impressive ami very useful ngsoutm 
Tlie only dJsadvnnlngje I’ve found is dial each answer the 
databases yield exposes me to so many mom issues, that 1 
find imself evplcirtng tile article for Hie slier wonder of il, 
and thus pulling off tie real ending I should he doing. :-)* 

- IVtcbolas ik Mdlo 
\ku th~b CD Beta Thkr 


ftp * IfAUlfll^ 

FnpfrtJiiBfn h Ofrdfl^rn 

MacSbcfr 

MAGAZINE 

Voice: 805/494-9797 * Fax: 805/494-9798 
J n ternet: cu si scrvicett x pla in .com 
eWorld; MTCustSvc • AppleLink: MT.CUST5VC 
C<jmpuServe: 71333,1063 
America Online & GKnJe: MACTCCHMAG 


/ 50 MB of MacTech Magazine articles. Volumes 1-10 

Every article, 1230+ of them, from alt J15 issues of MacTech Magazine printed 
from 1984 through 1994. Ankles ranging from Assembly to BASIC, C to Pascal, 
Forth to FORTRAN and mon*. And the articles are in HUNK Keferencef 

/Hyperlinks to Inside Macintosh Databases of THINK Reference 

Tlie a nidus have hyperlinks to relevant portions of the Inside Macintosh 
databases of THINK Reference. For example, if you are looking for 
information on Aliases, look at the MacTech articles on Aliases and use the 
hyperlinks to jump In the inside Macintosh entry for the Alias Manager And 
now. with the articles in THINK Reference, you can do free-text searches 8-10 
times faster than you could previously with On location™ 2.0, 


/ 100+ MB of MacTech Magazine source code examples, samples, 
and utilities. 

These are the files that go with the magazine - the code dial the articles are 
talking about. Use them in your own applications, with no royalties! 


/ A fully-capable version of THINK Reference 

Including /mute Macintosh Volumes 1-6 (7 MB). 


/ Sprocket - MacTcch s Tiny Framework. 

Build your simple application using a lean, mean application framework. 
Experiment with new code without having to build a whole application 
around it! 


/ 80 MB of Frameworks, MacApp® t 
M ADA and SFA articles, files and 
source code. 

The most complete set of Frameworks 
archives know F n. 

/Apple APIs, Utilities, and SDKs 

Including: Universal Header Files. Discipline, 
Macintosh Drag and Drop SDK. MacsBug, 
Telephone Manager SDK, Thread Manager 
SDK. TmeEdit L8 and and more. 


FREE! 

THINK™ Reference 

Symantec's T HINK Reference 
2,0, Complete on-line guide 
to Inside Macintosh, Vol. I-VI, 
with cross referenced index, 
detailed information of each 
function, procedure and 
detail needed w hen 
programming the Macintosh. 


SYMANTEC. 


/ Arid Publishing's Inside BASIC on disk 

...and other related BASIC programming information and toots. 


/ 75 MB of Special Demos relevant for developers 


MacTech CD ROM, Volumes M0: 

$49 plus shipping and handling. $39 plus shipping and handling for 
upgrades from any previous version of the CD. 














TCP/IP Scripting Addition 


The Internet Scripting Solution 

TCP/IP Scripting Addition vl.2 allows you to quickly 
develop Internet client/server applications. It grants 
access to MaeTCP™ 2,0,4 and Open Transport ™ by 
adding commands to AppleSc ript 

♦ Supports ScriptEditor, FaceSpan and HyperCard*" 

♦ Build net wise WebSTAR ™ CCl scripts 
and NetScape™ CCI scripts 

♦ Sample scripts include FTP, Gopher, BjfelUA 
Telnet, Post Office, E-Mail and more 

♦ FeaHired on the Apple® Internet Server 

Order now through the MacTech Mail Order Store al 
805-494-9797 or custscrvice@*plain,coni 

Mango Tree Software, Inc* 

Box 1057 * Brookline, Massachusetts 02146 
617 327 8663 

h 11 p ://www. ma ngo tree.eom/b iz/man go 

All trademark* arc prof jctI it's uf theif re p f O t w p holtlerv Contort Mango Tiw 
*kdlw,m* frw lilt* Ikvruing information. Cojiyriphi 0 1995 MTS* Inc 


C&eeperPart* ftWeperFur t; 

FVJIPushButtoir fBeeper: 

ODID fftuttonld; 

FU CHandleFuuetionCorynectfQii fConnection; 

ODTypeToken fBur t ooKot 1 f leaf: lonTokcn; 

CBeeperFrame includes a button gadget, so it overrides the 
mctlmd CreateGadgetLayout to create the button gadget, 
CBceperFraroe can accept a drop of either scripts or sounds, 
so it overrides CanAccep t Drop. Ii overrides Draw to render 
itself, and it overrides the FrameShapeChanged notification 
to update its layout when the frame is resized. Finally, it 
overrides the HandleNot iTical ion method from the mixin 
class FWJMReee f ver so that it can respond to button presses. 
Let's now look at the implementation of these methods. 


CDccpcif time: Ofcqx.rfrime 

CBee pe c Frune:: CBcepe r Fraw l Env l rofinen L * ov * 

QDFraae* triJtc* 

FV_CPreseiit«t ion * pre&etftac ion* 

CBeeperPart* part) ; 

FW CFraeetev, fraee. presentation, part). 

FRer*per Part (part), 
fBecprr (HtU.U. 
fButtonId(0), 

!Connection(this). 

FBut t onlioti f ica t ionTokerd 0) 

fConnect Ion.Connect(); 

ihln >AddToFoci;p,S^T («v,p»rf >CetC) IpboardFocusToken(« y)): 
SeiDroppabletov, TRUK ); 



class FV CUSS ATTR C&ceperFraa* : public FW CFraie, 
public FV HRoceiver 
I 

//- - — 

// IniujhsjhiHL/lkyfturi'iri 

ft 

public: 

CBeeperFraea(Environment* ©v. ODFrame* fraise, 

FV CPrenentatlim 4 presentation, CBeeperPart* part); 
virtual "CBerperFraimU; 


// FW l Hi mii it (Sc rid g 
ft 

public; 

virtual void CreateGadgetLayout(Environment• ev, 

FW CGndgerInitial Azeri initializer); 

virtual 0lllJra|Ronult CunAccopirnop(Hnv I ronmmf * pv t 
OI)J)ngU«ftlier*tor* ilreg.Jnfa); 

virtual void Hraw(Environment* ev. 

GEJFacat* facet, GDShape* invaiidShepe); 

virtual vntd Fm^eShapeChangedtEnviroiraeiif* ev); 

ft— -—-- 

// HIJUluImj wuilda 

ft 

public: 

virtual void Hand leNoUfieat ion C 

const FV CWorififationi notification): 


//—- 

ft Dots Hrmfecn 

ft 

private: 


The constructor initializes the fuse class and data members, 
and then sets up the notification connection, prepares to 
receive data from the clipboard, and registers itself as Ixring 
interested in receiving data Lhrough drag-and-drop. 


Cttoaper ¥ r :: «CKccpc t ¥t nut* () 

I 


< KrrprrFramc -4 VFk , t*ptrFramc 


FV Clot crest interest Cl Beeper, lliuttonltotificationToken]: 
f Connect loir. Reraovelnt crest (interest); 


The destructor removes the notification connection. 


(:\kx pi (frameotatcCtadgetLayoui 


void ti&evpet Fio»e: :CrcatcGii11go[Ljiyoui (Knv 1 ronaeni * 
FV.CCadg#t i td l isXiaerfc iai I iaIlaer) 


1 


FV CfrynamicString 1abe1(-Beep"): 


ov, 


FV CRecr frame&oct: 

thin >Oi FraaeShapeBoundGlev, fraielact); 

(Beeper * FV_NKV(FW^CPuahHmtoo, 

*>v, iaitlaUtcr, this, flottcmld, 

traaeRecilFV_idopLeltJ, fruoeRecr|FV_kBotRight]. 

label)): 

deeper >Set0efuilt(*v. false); 


(Hui tofiN«t i r leal lofiToken » 

fBeeper >£etBut tooFreesedHailficei lunTokro tev); 

FV_C!nteresi interest((Beeper, fButtonNai1 floationTokeo); 
tConnectipn*Add Interest(interest); 


50 


Tut; OhnDoi I Ji vi ioI'MIm PhamhwohK 


MacTechMagazint-: • Novemucr 1995 



























The #1 debugging and development environment for AppleScript ! 



Real step-by-step debugging 
Variable watcher & 
expression evaluator: set 
variables, in context, during 
debugging! 

Enhanced trace log 
FaceS pan™ link 


* Vocabulary access in a 
mouseclick 

* Power-assisted statement 
construction 

* Multifunction find & replace 

* Automatic navigation to 
subroutines 

* Background processing 
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I I you're an AppleScript novice, Scripter will take you by the 
hand and show you the correct syntax fur your statements. 
If you know what you're doing, Scripter will help you do it 
foster than any oilier editor. Scripter lets you debug properly: 
truly line-by-fine, so you catch the offending code in the acL 
And only in Scripter can you then fix the problem, and 
continue debugging — right from where you left off. In fact, 
Scripter has so many exclusive features, we can’l list them all 
here. So get a copy today, and start scripting with power! 

"Overall value ♦♦♦♦ ♦ 

Scripter 1.0 is top AppleScript editor and debugger... 
I! you expect to do anything more than idle fiddling 
with AppleScript, you need Scripter/' —MacWsBk, 8/12/95 
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+1 202 298 9595 mainevent@his.com AppleLink: MAIN.EVENT 


CreateGad get Layout creates a button of type 
FW CPushButton, and then establishes its interest in 
receiving notifications for hutton dicks. The notification 
subsystem is a general-purpose mechanism for establishing 
event dependencies between objects. Objects may serve as 
Notitiers and Receivers. In our case, the push-button is a 
notifies and the frame is the receiver. The FW_CIntcrGSt 
object establishes an interest in a particular kind of notification, 
in this case button pressed notifications. Adding the interest in 
the connection object establishes the connection. Once we 
establish the connection, button presses will result in the 
receiver's 1 landleNotification method (see below) being called. 

C IJtccpcrFramc: :CanAe<xpL 11 thjj> 

ODDragRemilr CBr^perFranie: ;CanAccepr.DropfEnvironment* ev. 

OriDraftTr^inTforaror* draglnfo) 

I 

GDDragResult acceptDrop - 

FW_CFraJn€; :CanAcceptDrqp(t;v, draginfu): 


return TRUE; 

1 

1 

i e L um a v ce piDrup; 


CanAcceptDrop iterates over the storage units of the OpenDoc 
drag item, looking for one that contains recognizable data. If it 
finds either a sound or a script, CrmAeceptDrop returns true. 


void CBeeperFrame: ;Draw{Environment * ev. 
GDFacet* facet. 

ODShspe* invalid Shape) 
t 


(^Beeper Frame:: Draw 


FWjTFacetCtintext fc(ov, facer, invalidShape); 


//jtiss t rase am) assume gadgtls will draw 

FW_CRect invalidRect: 
fc.GetClipRect(inva1idRec t): 

FW CRectShape:iRenderRect(!c. invalidRect. 

FW kFill, FW kWhiteEraselnk): 


l 


if UacceptDrop) 

I 

Tor (ODSlnrigrdJnir *dragSU - draglnfo->First (ev); 
drugSU I* HUM.; 
dragSU “ draglufo >Kext(ev)) 

I 

it (CSoundAction::IsinStoragelev, dragSU}) 
return TRUE; 

if (CSctiptAction::IslnStorage(ev t dragSU)) 


The only rendering that a CBccpcrFrame needs to explicitly 
do is to erase; the PushButton gadget will draw itself 

Ukcpcrfrattit:: I huitlkNiHifiailkin 

void CBeeperFrame::HandleNorification( 

consi FW CHotiflcationi notification) 

( 
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OranlUStall makes your installer choice easy 


Easy for your users 

DraglnstalTs unique drag-and-drop interface makes installing your 
software a piece of cake for your users. And cuts down on tech support calls. 

Easy for you 

Dm gins Lall's Builder utility allows you to create complex installers in minutes 
not days. And without the need to learn a complicated scripting language. 

Easy on your wallet 

Dra gins tail's one-time fee of only $300*00 allows you to distribute an unlimited 
number of installers. No yearly renewals, no royalties, no hassle* 


To find out just how easy 
Dragfnstall is, call us at 
1-800-890*9880 
to receive a free demo disk. 
Or contact us at: 

Ray Sauers Associates, Inc* 

1187 Main Avenue* Suite IB 
Clifton, NJ 07011-2252 USA 
Voice: 201*47^1970 
Fax; 201-478*1513 
E-mail: tfraginslali@sauers*com 
h tt pw w w, sauersx cwn rd ragi n stall 


const FW CBuTtonPrenoedNot ificat ioriA buttonPressed ” 

<FW CButtcmPrencHMot I ft cot lottij not if lea Lioti; 

If (bin t nnFrcoacd .€ol Hull util cl U “ fButumid) 

I 

fBeeperPsrt - >BoAttloti (); 

I 

Tilts method is inherited From FW_KReceiver, and is called 
by the notification subsystem. This method first checks to 
ensure that it is receiving notification from the correct button, 
and then forwards the action request to the part (which will 
forward die request to the current CAct ion object), 

t .Recpcriranx';. tnimcStLipct .hanged 

void CBi^pertVflme: ;Fr4fteSllJlpeChfln|t€d(Bnvirontaet^t , ev) 

l 

FW CFraiae: :Fra»eShap£ChiiftRed(ev); 

// Hoiiwr the Bcrpcrto 111 the new farm 1 si tjc 

FW CRert frameRpct: 

t h I n ■ X*et F rawr-Shfl pc Round n (ov , £ r umeRuc i): 
fBeepwr v,v (t?v, t rucekecc. BotRight ()): 

// Kcdnw the cm Lit' frame 

this >lnv*Hdate(ev): 

I 

When the frame shape changes, the Ira me simply resizes the 
push-button to lake up the cnlire frame, 

C P e cpcfSd cctioii 

Tlte ODF class FW_CSe lection ts an abstract base class 
used by ODF to represent the users active selection of data, A 
Copy command will copy this data to the clipboard, drag 
operations copy or move the selected data, etc, 
FW CSelection defines four pure virtual methods that must 
be overridden; FW_CBeeper Select ion defines these and 
overrides two more. As it turns out, the "selection" of a Beeper 


pan is always the entire data content, so the implementation of 
these methods is especially simple: most don't do anything, 

class FV_CLA£5_ATTE CBeeperFart: 

class FW„CLASS_ATTR G&eeperSelettimi 2 public FW CSelectioa 
I __ 

// Inrlali/Jlnifi/iX-sLnktiufj 

n 

public; 

CBeeperSeJectIont£nvironment* ev, 

CBeeperPart* beeperPart): 
virtual -'CBeeperSelecTionO: 

// - - ---- 

// Inherit'd API 
// 

public; 

virtual void CioseSelettion(Rnviraiment' ev): 
virtual F&L&ooiean ClearSeJcct ientEnvironratfiit* ev, 

FU ClearSelertinn clearAfter); 
virtual FW Boolean lnEmpiy(F,nvt rouucnt * rv) cofiut; 
virtual void Selec tAll tltnvl ronmnni * nv); 

virtu*] void t)oE* L crnuli*uSoJ cm: limit Environment* ev* 
OUStoragelinit* storage* 

FW_CCloneInfo* cionsInfo); 

virtual FW Boolean Dolnternal ixeSelcrtlonCEnvi ronmetit * ev, 
ODSto ravelin it * ntorage, 

FW CClonelnfn* rlmirliifiOj 

// Data Members 
// 

private: 

CBeeperPgrt* fBeeperPart: 

I; 


<:!k,xpcfStktlk>o OfccpcTScfciliun 

CBeeperSelection; :CBeeperSelecT:ion(Etiviroo*ent‘ ev. 

CBeeperFart* beeperFart) : 

FW_CS®lection(ev. FALSE. FALSE), 
fBeeperPart(beeperPart) 

l 

1 
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Guide Composer 

Previewed at WWDC *95 


Develop Apple Guide files for any 
new or existing application 

Avnibble from the MacTech Mail Order Store 


• No Programming 

• WYSIWYG Content Entry 

• Coach Marks 

• Index Terms 

• PICTs 

• Sounds 

• Integrated with Guide Maker Lite 
(included) For Easy Compiles 

• Optional Source Code Output 

• Change back from your $100 


Demo Available: 
AppleLink, AOL,CIS. 
eWorld. I ntcrnei: Info-Mac 


$ 

Ma(T0S 


$99 


(IildtOHIkM h * lln4.Mli *4 Sfcfti 1(1 JtMlImK Oolite MnkwT w * Umliuuit <J Apjilrfnifvln. >nr 


$TEP UP 

SOFTWARE 


7110 Glendora Avenue 
Dallas, Texas 75230 
214-360-5301 
214-360-0127 fax 


The GBeoperS^Iert Ion constructor simply initializer its base 
classes and caches away a pointer to the pan. 

CBcrpCfSdrclion H JlcrpcrSdctf it in 

CBeep p r So 1 ec t ion:; bee pc rSelec t i on {) 

I 

The destructor doesn't need to do anything. 

OfcqxTSdccthm; O* *cSdrctiun 

voiit CBeeperSeitction; iClofleSelectioniEriVirontaont * t?v) 

I 

i 

In our rase, closing a selection is a no-op*.♦ 


The Beeper's data is always selected, so there’s nothing to du. 


tJkxpcjSclectitm:: I JoExternaJi/eSelcakin 

void CBcepetSelection: :DqExternal izeSel action { 

Environment' ev. 

ODStaragwUnit* storage 
FV CClondnFo* cl uric? Info) 

I 

CArtton ‘union ~ It* coper Fart >CetAetionO; 
if feet ion) 

I 

storage >AddPropprty<ev, kODPropContenrol ; 
act ion->Exr*rnaIizetev. storage); 

I 

I 


DoExternalizeselect ion isn’t a no-op, but ii is still trivial; 
We merely forward the operation onto the action object. 


(IBccpeiSdcn u mi t IcufteU-ctit ifi 

^Boolean CItoeperSelact ion: jCJflarSelert InntRiiv i ronmimt * i*v, 

FW ClearSnlert lari rloarAftcr) 


I 


return FALSE; // Do rurthing 
I 


,„as is clearing the selection. 


QkcpctSctcci K»n bFmph 

FV. Boolean CZtaeperSelection;: IcEitnty (F.nvi rona^m ■ e*) const 

return (fBeeper Port >GetArtlonU ” NULL); 
f 


A CBeeperSel set ion is empty if it does not have an action 


< 'Jtccpc rSctcojon: SHrttAfl 

void CBeeperSelectlon: :Select Alt (Environment* ev) 

l 

l 


(IlkcpoSdcCt ion J )olnicnulizcSdcctit*n 

FW_Beoiein CBeepefSelection: :DeInt*rnatixeSel*rtion( 
Enviionnent* cv, 
nDStorngnllnir * at orage* 

KW CGIoncTtifo* cloneinfo) 

I 

FW_JJoolean internalized * FALSE: 

CAction ‘action - NULL: 

if (CScriptAttion :: IsrlnStoragelev. storage)) 
action ■ nev CScriptArtlon(): 
else if (C&oimdAi'i Ion:; IsInSturage(ev* storage)) 
action w nev CSuimdAct louth 

If faction I- NULL) 

I 

action->IntenialUe(ev. sstorage); 
fBeeperFart * >SetAct i on(ac rton): 
fBeepefFarr }Oiarigci)(uv); 

Internalixed * true; 

I 

return internalized: 

I 

DoInternalizeSelcction is slightly more complicated. It 
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should look familiar; since there is nor much difference between 
this method and the CBeeperPart::InternalizeContent 
method. We simply determine type of data to internal i/e. create 
die appropriate action nhjetl, initialize it with the data, and then 
ask tlx part to make ii lx die current action object, 

WllAT EIAVE WE DONE? 

You’ve now seen all die custom code needed to create our 
enhanced Beeper jxirt It is not really a complete part yet; it is 
missing some obvious features that a truly usef ul deeper should 
have, not the least of which is a I setter name* 

One key feature that the Beeper needs is the ability to 
diange the title of the button. If you took back over the code, 
you’ll see that die button title is haid-coded to lx Beep inside 
the method CfleepctFrame:: CreateGadgetLayout. A 
real pan would allow die default title to he specified front a 
resource, and provide some simple means of changing the title 
One possibility is 10 allow dropping a text clipping as the 
means of setting the title. Another possibility is to set the 
button title to the name of the file dropped onto the button. 
No doubt you can think of other features that a hunon-as-pan 
should have, such as a visual style mure interesting than die 
simple n >uruled-rectangle 

If you look past these 1 shortcomings, I believe it s fair to say 
that this example is a pretty impressive demonstration of die 
power of OpenDtic and DDK With only a small amount of 
code, we have created a truly reusable software component, 
Pm not talking about the code-level reuse that we were able to 
achieve by using Ol)F f which is no small mailer Pm instead 
talking of the much more drumuiu reuse achieved by high-level 
componenti/ation. Tlx* QDFBecpei: part is a component that 
can lx reused without needing a single additional line of C++ 
code. End users with just a modest understanding of 
AppleScript could use the DDF Beeper component to create 
application* customized to their needs. 

Clearly, the ODFBeeper component by itself, or even 
combined with a container pan like ODFDraw, would not 
significantly empower end-users. We need quite a few more 
components before well see such a dramatic: shift. However, 
considering how easy it was to create this component, it 
doesn't take much imagination to believe that we could soon 
have a wide assortment of powerful components. 

Wrapping Up 

With that uplifting vision of the future, it s rime for me to lie a 
bow around this article ami ship It. One of my goals for this 
article was ro give you a taste of wliat it’s like to develop for 
OpenDnc with OOF. Hopefully it's left you thirsting for more. 
If you’d like more information about CDF, send a note to 
odfseed@apple corn; or feel free to w rite to rne- 
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Apprentice 3 

"//4 wonderful. ftS sat ed 


"Its n under ful. US sated 
me probably 20 hours of 
tune injyst the fast week, 
tt fa wet! ^orth adding to 
voir condition, definitely 
one of tbd'fnost useful CDs 
in my collection . w 

■ ||* . •• / \ - Peter Lewis 


mm 


Mac Source Code CD-ROM 

tfyqu'm looking for great sourer code examples, this is rheCfMECJMinf you. Over 640 
mepbtfPf of Ngh-qualiiv and ufMinUiv Mat only source code from hundred* of 
piogrjfntnefv ()«f 80 percent of the puhy^ and utilities arc new to ihis release, 
mo^ly in C, Cv+, and Pascal, irung CnttoWamor, Symanrei,, and MFW Includes 
wjfnples of applications, games, rode resources, comrol panels system extensions, 
plug-m modules, hundreds of snippets, and much more 
$3!>. Upgrade from any previous Apprentice release for only $25! 


Shfpna m bdai tor UJL tml Cgudun qrdav Add 55 tar shipping outsidr (he tJi and farad* 

Visa, MasterCard, American Express, and Discover gladly accepted 


Celestin Company, Inc,, 1152 Hastings Avenue, Port Townsend, WA %3h8 
800 835 5514 • 160 385 3767 • 360 385 3586 fax 
Internet; celestintceleslin.com * http;//wvvwxeleslin.com/ 


Novi mui k I99S • MacTeoiMagazenh 
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By Neil Ticktin . Edtior-in-Cbief/Publisher 



Dyian Lives 

Jim Gagnon (Dialog Box, September! may Itave many reasons 
for mu using Dylan. However, “.. unreasonable to ... expect 
success from a proprietary language,./ shouldn't be one of 
them. [The fad that it isn't out yet in reudy-for-prinie-trrne form 
is a reason.) 

'Hit 1 language spec is in tile public domain, 'Hie keepers 
are at CM! L.take a look at 

hnpiAegend. gwydion.es emu, «ki:8001 /dytan/ 

The name Dylan remains with Apple for the purpose of 
controlling its usage to conforming implementations (aging 
entertainers who themselves appropriated the name 
not withstanding). Apple may someday have a Dylan 
implementation available for Mac developers. Meanwhile 
Dylandike things are ‘all over" on other platforms (and 
Macintosh). Ihey aren't called Dylan because they aren't yet 
(as in “Mindy/..Mindy Is Not Dylan Yet). 

- John W Baxter, Port Ludlow , WA 

CGIs iw C - Some Tweaks 

Just a few notes on the article "Writing CGI Applications m C* in 
the September, I99S issue of MacTech. 

POST arguments can be up to 32k in size (not 24 as 
indicated on pg. 36). The username and password are lx>th 
limited to 32 bytes. 

You state on pg. 4 1 that H you can not allocate or release* 
memory within a thread context/ This only applies to pre¬ 
emptive threads, which were only implemented in the 68K 
Thread Manager. Cooperative threads can do what the main 
application thread can do. 

I haven’t looked at the responder code recently, but it used 
to lx* missing the call to MaxAppfZoneO during startup. That 
becomes quite necessary il the application is going to be 
dealing with large chunks of data. 

Thanks for writing the article - l got some useful ideas 
from reading it! 

- Grant A eufeld 

According to John OTaihn, the point about using memory 
Within a thread context is true . hut remeber that a call to 
MaxApplZone is required before threads allocate memory See 
Mat Tech, Not'em her 1994, P 68 for more details there are 
many things that Responder doesn't do, mainly because 
Res/xmder is a simplified application to teach CGI programming. 
- fid. nst 


What Ever Happened to FORTRAN? 

first, lei me laud your publishing of articles on Prograph CPX. 
This certainty is the way of the fulurc of programming on the 
Mac. Indeed it Is a natural extension of the Mac's iconic 
interface, I'm also delighted to find that there are two books in 
the offing concerning the programming of CPX. My background 
has lx*en in the procedural languages, and I need some exrra 
help in making the culture change to OOP. 

Second, let me moan. In the past MacTutor and then 
MacTech gave coverage to the language l use most of the time - 
FORTRAN (IS FORTRAN). But the past year or so has seen a 
withering and then total atssence of coverage of this language - 
first Jorg's Folder, then Jorg. tJien FORTRANs from the Mail Qider. 
I know it isn't the most modern language, but there is a 
considerable opus of large scientific/engineering codes written in 
FORTRAN which have lieen defmgged over decades Those who 
use lliese axles are first of all rattier intimidated by the kk-a of 
converting them to other more modem languages due to their 
size and second do not relish the large amount of time it w ill take 
to make the new axles as reliable as the existing FORTRAN 
codes. So. I don i think that FORTRAN Is dead by any means and 
it is disa|>(xnnijng not lo have Jorg's Folder any more, especially 
with the evolution of the Power Mac versions of FORTRAN. 

- Stu Cook Ait St Hilaire , Quebec 

IStu Our biggest reason for not running FOR'IRAN articles is that 
we've not seen anything utorthy of printing While FORTRAN 
articles shouldn't get the same volume of coverage that C++ or 
even Pascal should (since there are more users of those 
languages), it does desene unerase. We re ofxm to publishing 
LK)RTRAN articles - anyone interested in writing one. 7 - Ed mil 

But, You Missed The Point 

Thank you for your comments at the end of my letter 
complaining aUxtl Symantec's C++ H,0. but I think you missed 
Lite point of my last comment. 

If it would he so hard to write a PowerPC version of 
THINK Pascal, then how alxntt a compiler that will accept 
THINK Pascal source code and pnxluce native PowerPC object 
axle. We programmers could do our program development 
using the present THINK Pascal development environment in 
the 680x0 emulator. 

The THINK Pascal *1 0.2 compiler in the emulator is so 
much faster than any native C or C++ compiler that there is no 
real speed penally for using the present compiler After we have 


56 


Dialog Box 


M \« Ft < iiMaoa/.ini • Novi mmi k 1995 


















;i working 680x0 program, we t an feed the source code to the 
PowerPC compiler to produce the final code. 

Since we will only he using this compiler a few times per 
program development cycle, it tan lx? a slow dog like the 
Symantec C and C++ compilers. It doesn't have to have an 
editor and debugger like a real development environment. It 
just has to reliably compile previously proven code that was 
developed using the present excellent THINK Pascal 
devek ipnient en vi re in ment. 

- Fred Johnson, Knoxville T Illinois 

fFretl, ) mu'prayers butt* (or uill) he answered shortIy Will Person 
at Symantec tells m that Symantec has come to an agreement with 
f/wi*uai>c Systems Corp IS trill prut ide art Object Pascal compiler 
that will drop into the Symantec Project Manager environment 
that should compile THINK Pascal 4.0.2 source code. For more 
information , contact Language Systems can he reached at 
http://waw. kmg$ys>com/lang$s or HQO-252-6479* 

In addition, there is a version of the Universal Headers 
modified to work with HUNK Pascal that Symantec will make 
available by the end of October, 1995 These files will he 
available on the next SPA CP and probably online. Check the 
Mac' Tech tteh site (hltp:/fwww mactech.com/slxtciatMtml) or the 
Symantec site for more information - lid nsfl 

I Many thanks to: 

Daniel LidofT, Atascadero, California 
Jt'cnorlMtaoLcum 
S.A. Klein, Madison, Wisconsin 
Anthony Panics 
human Wing 

Chris R Riley, Miami, Florida 

who also expressed similar opinions about wanting to brint* 
THINK Pascal to Pouer Macintosh - lid mt! 


Brain Damaged Languages? 

Fred Johnson hit ihe nail on tire head with his letter, printed in 
the Dialog Box section of the March issue of MacTech. He 
praised the editor and linker ol III INK Pascal, as eomparrd to 
those 1 of Symantec C++. Hut he did not go far enough [to fully 
expose the languages Ixdund the environmcnlsf 

l f like Johnson, ani somewhat of a Mac hacker. 1 have 
programmed tire Mac professionally, but I consider myself to 
Ik* an engineer who programs rather than a programmer I 
have programmed using THINK Pascal, THINK C, and 
Microsoft QuickBASIC, 

The BEST feature about THINK Pascal is its debugger, 
LightsBug. It *s superb and dearly tetter than anything eLse t 
have used. (Why hasn't Symantec made the C/C++ debugger 
more like LightsBug?) I can examine all global and local 
variables immediately, without having to first select them for 
display as in the THINK C debugger. 1 can see the chain of 


calling routines, examine register variables, look through the 
heap, modify variables, and set watch points. And I ran also 
examine and set memory directly. 

I also share Johnson’s opinion of C and C++ for rather, 
Symantec * rt G with Disjects", which is as close as 1 have gotten to 
C++.) Both are a mess. For example, what kind of brain-dead 
language knows the type of a variable in a "printftr function 
calf yet makes die programmer specify it again with u formatting 
control code? I end up debugging tny “printfCT fund ion calls. 
(And that is just one example. I could go on anti on.) 

J made two serious efforts to learn “C with objects” but 
gave up in frustration both rimes. Object Pascal was a breeze 
after wrestling with O (Even the manuals bear this out: the 
"Object Pascal” chapter is 14 pages for version \ of Pascal; 
the "Using Objects in Think C" chapter is 37 pages for 
version 5 of C.) 

The Object Pascal implementation of object-oriented 
programming is simple and elegant. With the use of just 3 
additional keywords (“object", "inherited", and “override") and 
one function ("memheKn, 1 can program in an OOP language. 
Although I ( an’t speak from experience with C++, if my 
experience with “C with objects" is any indication, C++ Ls a mess. 

The world seems to have run after C t hut after using both, 
t don’t know why. C is best described as a cryptic high-level 
assembler. Pascal is a well-designed high-level language. 
Ctnon Symantec, support Pascal. 

- Steve Ross, sk it wjnxss&s mtp st tlJne.com 

Criticism of Programming Stylf 

l just received the winning solution to the programmers 
problem. It uses several goto statements and is not object 
oriented. As the only programming journal for die Mac it would 
lx* nice if you'd adopt a more “progressive" approach lo 
teaching programming. Old notions of "efficiency" are passe. 

— Don Winston 



Chasing Down Semper.Fi 


Due to listserver changes, the instructions to 
sul>scrilxr to the Semper.Fi mailing list in the Septeml>cr 
Viewpoint were obsolete soon after we went to press. 
Here are updated instructions: email to 
liMpnA@abs.apple.com a message with this command in 
the body: "subscribe semper.fi <your name here>*. 

If you want to see what other lists arc available from 
ibis listserver, send the "list" command, or see die web 
page I HLp://abs^pple.Com/appIc internet/. 


NoVRMRF.it 199S * M aiT'h ,11 Mai ia/inf 


Dialog lk>x 
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By Jim Straus. URLs@tmtctecb.com 


Sparc your Ungers and find this column online at: 

http;//www. mactech c o m/u R Ls, htm I 

Also, for a limited time, you can send mail to: MacTeth- 
URLs@dass.com and you 11 receive lilt 1 latest list back. 

Latest Updates 

Internet Re la ted 

t ist of Mac Malting lists hitp:/ftwmm 

New Technologies 

Open transport and PCI hap://pilot nj1n.net/- mspmul/ 


issue Ls Septemlw (when I’m writing this column), and die first 
issue has several gtxxJ articles. I hope that by the time vnu 
read this it will have developed and die content will be even 
better Check it out for yourself at: 

Mac Ma garin e http://oeon I i n e.com: 80/ - tomk/M at M aga 2 i n e/ 

A site that has been around for a while but Ls a good site to 
check out. is the l it.TIM ATI- Macintosh This site has links to 
tons of stuff. A good place from which to branch out into the 
Macintosh universe on the Internet. Branch out from: 

The Ultimate Mac http://www.freepress.com/myee/ultimate mac.html 


Other Programmer Resources 

fortran to C converter ltp://alumnixaltech.edu/puh/Mac_FK/ 

Grant's CGI framework in C http://afpp1 xarfeton ca/grant/mac/granlstgi/ 

MacHa t k http^/www machack.com/ 

Parse CGI OSAX hnp^/marquis.tiacnet/soflware/homeiiiTnf 

Prefab Software mpJtwww. tiat.net/prefab/ 


Vendors, Products and Miscellaneous 

Absott tmp://www.ab 5 oft.coni/ 

Madias Group htfpJ/www.hajetam/hax html 

telesim __ http://Wwwxelestifuam/ 

LPA Prolog http^/www. lpa.co.uk/ 

MacM agazine http://oeon lino. com:8Q/“ 1 omk/MacMagazim?/ 

Mac Net Journal http://www.dgr.com/weh_mnj/ 

Mac Week ht tp://www.zdne t com/ - matweek/ 

the Ultimate Mac htip://www.fre<^rc©xom/myee/ultirriate_mac html 

VIDI fit lp://erehwon.caltech.eduMliAnrf t homepage hrml 


Internet 

Mailing lists are one of the more popular ways of distributing 
information on the Internet. Ttiey can reach a wider audience 
than news groups or the world wide web, Iv more selective in 
their distribution, and reach their readers in a more timely fashion. 
The Well Connected Mae has a list of over 150 Madmosh specific 
mailing lists that cover a large range of topic's. You can subscribe 
to as many as your patience and mailbox will allow. 

List of Macintosh Mailing Lists http^/www.macfaq.com/mailingtists.html 


Neat non-Macintosh sites of the Month 

Keeping with the theme of electronic magazines. 1 would like to 
draw your attention to The Feed. It is a fully electronic 
magazine (no prim counter pan) and is a view of what 
interactive publishing could lx like in the future. Some very 
notable people contribute in The Feed and you can interact with 
them through 11 ie Feed li is a professional magazine, well 
layed mu; and with good content. Highly recommended at: 

The feed http ://www.emedia.net/feed/ 

For rimsc of you not in the Silicon Valley, you might wan! to 
check out the San Jose Mercury News, Thus Ls an on-line version 
a newspaper that covers the Silicon Valley. These are the same 
people that bring you Mercury Center on America On-line. The 
top stories and index are flee, but there Ls a subscription charge 
to see everything (though it is a lot less than subscribing to die 
paper itsdf). They also have a service railed NewsHound that 
can automatically scan the news for key words and send you the 
articles, A start a! agent technology. Read the paper at: 

Mercury Center Imp: //www.sjmercnry.com/ 

Well, that’s it for this month. As a ways, if you Imd 
something interesting, or have updates, send them to 

URU@MacTech.com 

Thanks to, and many others for their contributions for their 
suggestions and pointers to new and old sites, Ajxdogies to Jon 
Pugh for misspelling bis name in die Septemlx*r issue! 


Macintosh 

There are several on line magazines for the Macintosh 
community (besides MacTech, of course). You probably 
already know alxnu MacWeek, but did you know that it is 
available on-line? In case 1 you don't know alx>ut Mac Week, it is 
a weekly magazine tluit was often referred It) as the way that 
one hand at Apple knows what the other hand wits doing, and 
there Ls some truth to the joke. You can line I it at: 

Ma c Week h ttp ://www, rdnet.com/ - ma eweek/ 


Internet-Related Material 

Apple Internet mailing lists http://abs.apple.com/app1e-intemee 
Bolo http://batoncsauEoc.edo/ 

Gay Basket htrp://www hotwired.com/sraff/useflafwJ/ctay/ 

Consensus http://www conscnsus.com:8300 

CU - SeeMe http ; J/www, jongle.com/msattfer/sri tech/comp/C U -SeeMe/ 

OigiCash hitp://yvww,digicash. com/ecash/ecash- home In ml 

forefront Group (GrabNof) htfpJ/www ffg.tom/ 

Inb-Mac Searcher http://www.mid.net/INfO-MAC 

Internet Config hp^/ftp. share t om/pub/imerr>et-configuratioa/ 

I nterN 1C bitp://www. internit.net/ 


Another new on-line publication is MacMagazine. It’s first 
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The Scriptable Database Client 


DataScript is probably the quickest, 
easiest and most cost-effective way 

to make your integrated AppleScript 
solutions database aware - today. 

DaUiScnpt can Ixr purchased frum General Knowledge by plrnnc, 
fax or INTERNE!' using VlSA/Miis^c^rtJ or American F-xprc^s 
DataScTipt is alsoavailable from the MacTedi Mail Order Service 


quickest. You can make new or existing scripted solution* thtatusr 
aware m a flash. It takes ju& six lines of Applet n|g to ferdi data from 
an industry standard daUllmse marugt'menr system such as Grade. 
Sybase, DR2 or Informix VEe dunk you’ll be pleased with it's 
performance loo * it launches in an instant and b available accelerated 
for PowerPC 

easiest. Day Scripts scripting vocabulary or terminology is easy to 
learn, easy to use and easy to rcmankT If you’ve done any scripting 
before then you'll be running with UataSeripi In no time. If you’re new 
to AppleSc ript don’t worry - Inside DataSeripT con rains lots of easy to 
follow script snippets which you tan refuse in your own solutions. 

cost-effective* Because DataScript is so easy to learn and easy 
to use you’ll become productive very, very quickly Once you're ready 
to ship your finlslted database aware solution you’ll lind our licensing 
schemes very attractive 

Telephone +44 1202 7464)26 
Pax +44 1202 715GIM 

INTERNET knowledge! 4 eiaappleUnk.apple.com 


ISP FAQ htipJ/www.arria/ing tom/intetnet/ 

ISDN page hi tp //a lumru .cal lech, edu/ -dan k/tsdrV 

Peter Lewis h up://www. diare.com/peterlewis/ 

see also ltp://fip.share.com/pub/peterlewis/ 

see also ft p/Mmug ,acg/pu b/petcr!ewis 

List of Mac Mailing Hits http://www.madaq.coTn/mailmglists.html 
Lycos (Index of the Internet) http;//www,lycos.com/ 

MacHTTP also WWW) 


Mailing Usi http//wvwbiap.com/machttp/mai ling_fisi.html 

Regi si ry hup J/www. bamet, com/ape/mac http j alk/mac h 11 pwtver s. by mac. html 

Extending MadHTP 

ltup://vvww.uwtcwashington edu/Compuiing/WWW/l essons/START HERE.btml 
Mai W*4i http://gaiaKy.eme I, rvet/FINei/MacWeh/MacWcb Home, html 

Matthias Neeracher http ://er r, el fti, dtfmember s/neeri, html 

M E RIT Searcher htip://pubweh nexor co.uk/public/mac/ard^ive/wekomeh 

OpenTransport/TCP gopM //seeding.apple.com 

Outland fipv/ftp.outtend.com/ __ 


Portable Net. Graphics 
SoiptWeb 
Ejk Stouten (TCP) 

SGML, Info 
C Parser 
C++ Parser 

WWW, ton W Mac WWW ffevetapmeni Guide 


ht ip J/sumrte. unc.edu/ - boutell/png. htm I 
http:ltmtw.qz cooi/scnptwetV 
httpV/Www.metrowerks.cocn/tcpip/inciex-himi 
http J/www^il. org/sgml/sgml. him! 
ftp //ftp. jdar k .com/pub/sgmh 
ftp.//ftp, jdafk com/puh/sp/ 


httpJ/www uwte wash mgion edu/t omput mgAA/WW/Mac/Dircaory. htm I 
CGI demo/info http://< liarln tie aens nwu.edu/mailtoob/ 

ftp://acnv.nwu edWpub/jlnstuff/mailtooiy_ 


Inlro In WWW hnp://www eit.eom/web/www.guide/ 

Web66 h1ip://Web66, coled umn.edu/ 

Non Mac servers httpJ/www wlorg/hypenext/WWW/trbra^^ 

Yahoo (Great index of the Internet) hrip.//www.yahoo.com/ 


New Technologies 

AOC [ ftp://ftp.andiew rmu Kiu/pufo/aoce/ 

http://www.njnl r ib.andrew.cmu.edu/usr/jbbt/aoce/aoce .html 
Apple, ftp ftpJ/flp.mfo apple.com 

Web interface to ftp hup://wwwjnfo.apple.com/tgi-b[nAtstef-pl 


DTS 

fech Notes 
see also 
Apple Guide 
Dylan 
see abo 
see also 
see also 

Mailing list archive 
Marlais 


http://www mf o, apple.com/dev/dts html 
http://www, info. a pple.com/dev/iechnotes/Main h irol 
http://www, a ust in. apple.com 
http://www g uideworks com/ 
http://www. Cambridge apple, com/ 


ftp^/cambridge apple com/pub/tfylan 
http://icgend.gwYdmts.tmu edu:8001 /dylan 
news/tomp tang dyian 

ftp //Cambridge apple c om/pub/dylafi/maib archive/ 
ftp://ftp.rjs, ufl.edu /pub/src/Martar$ 

h ttp://www.cis.ufl.edu/ -piw/Mariais/ __ 

Mindy ftp://ftp.bdi conV/home/bear^ 

Kalelda http://wwwkaltoda.conV 

Open Dot/Bento5Q M http i/www, cilabs.ofg/pub/alabyicctv 

htlp ://www. mf o. apple. com/dev/durintro_to_oper>dtx/K)dO_ir>dex.htTnl 
OpenDix Part Ideas 

http Jtmm eng.uci edu/^sr ouvsey/Net VismrVsaftwar e/od parts/ 


Continued on page 62 
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By John Kanaka mi y MacTech Magazine Editorial Assistant 


Code Warrior 7 Denvers 

The anticipated GideWarrior 7 has shipped CodeWarrior now 
comes on two CPs - Tods and Reference. They are designed 
so ihxir you can install from the Twls CD. and pop in the 
Reference CD for, dciaunentation and information. 

The Code Warrior IDF now has new Target preferences, 
with Plugin preferences for languages (C/C++ and Pascal), 
target platforms (Mae 68K. CPM 6HK f PPG, Win32/x86, and 
MagirCap), and tools to import from other formats, such as 
MPW libraries. The installer will install all the correct flies for 
each platform you choose, including stationery. 

Other changes include improved access paths, mod date 
checking, multlbytc* characters in comments ik strings, 
Enable Disable IX-bugging opiums toggle the Run.Debug menu 
item, debugging for non-applications, and searching in the 
Message window. I he 6HK anti PowerPC debuggers have been 
merged; debuggers Win32/x86 and Magic Cap are still separate 
applications, but they all work in much the same way* 

A new debugger nub, named Metronub also makes it's first 
public appearance on CW7. It is intended to replace 
DebuggeriNTT anil PowerMac Debug Services. Metronub is a fat 
binary on steriods; it supports 68K. CFM68K and PowerPC 
tie bugging services. 

Changes in the C++ compiler: support for R1TI and new 
cast expressions, I letter error messages* new virtual function 
dispatch method, more efficiunl class layout* improved code 
general ion for Mines, support for throwing exceptions with 
destructors, multiple exceptions, new pragmas for 
Import/export, and new reserved C++ keywords. 

Warning: All C++ libraries and all precompiled header files 
must be regenerated for this version. 

Pascal improvements: Pascal is now available as a compiler 
tool in the Code Warrior II )H, for the Mac OS only. Includes 
new types: UNSKiNHDWOHI) (16 bits) ami UNSIGNEDLONU 
<52 bits); new function: ReadString* wliich gets its input from a 
character string and can convert characters to different types; 
and PACKED ARRAY OF CHAR can now be mixed with the 
STRING type 

68k improvements: links all compiler-generated otxle and 
Tmable to inline" axle into segment 1* links very large projects 
fasten 

PowerPC improvements; Smaller viahles, smaller and faster 
C++ code; new preference for storing static data in TOC, 
PM ADD and FMM.IB instructions, and traceback tables. 


Supports pipelining for 601, 603 and 604, new intrinsic 
functions, links very large projects faster, new Linker preference 
controls link memory/speed tradeoff, other optimization and 
code generation improvements. Makes source-level debugging 
info for inline and template functions when "Don't Inline" is 
selected* Allows you to throw exceptions from Shared Libraries. 

Debugger improvements: the debugger is now a single* fat 
application that debugs 6HK and PowerPC code in either C or 
Pascal. Now has support For debugging C++ exceptions and a 
menu item to turn this feature on or off Also comes with a new 
debugger nub, MclmNub, in replace both DehuggeriN IT and 
PowerMac DebugServices 

PowerPoint improvements: LString classes for Pascal strings 
improve string-handling; new array classes; and new pane 
classes: LleonPane, LGroupBox, l/FextButton. In the 
Experimental folder new table classes for multiple selection, 
variable-sized rows and columns* and different storage models* 

Constructor improvements: Entirely rewritten in 
Power Plant* contains Views, Text Traits and Custom Pane Types 
editors; many tools for editing PPobs including layout anti 
hierarchy windows* automatic Tab and Radio Groups* new 
classes on T<x>ls Palette. 

In addition to the afxivc, there an: more improvements to 
other parts of the distribution. For more information* 
Met r< >werks, cnui i I: rnfo@metrowerks.com. 

FANTASM AssiMHIiR 

Programmers looking for a low cost ansember will want to try- 
Fantasm from Ughtsoft. Ugthsofl claims “In tests against MPW. 
Fantasm was many times faster and produced code that was 
only a fraction of the size of that produced by MPW. Example; 
for a simple Macintosh editor based on te, MPW generated 82k* 
Kant asm generated 18k," 

Version 3 20 of Kant asm was released recently, and all 
registered owners of 3 xx should have the latest version. If you 
are a registered user and have not received the ujxlaie. send 
email to I00625*720@compuserve.cxxn for more information. 

If you are not a registered itser of Faniasm there's a demo 
version, V3.20 (UnregX available by ftp from: 

ItpT'/ftp.demoneo.uk/pub/mac/faxttasra 


The OpenMac Free OS Developers Mailing List 

There's a new r mailing list dedicated to the technical aspects of 
porting different UNIX flavors, such as Linux and NetBSD 
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(referred to here as the OpenMac projects), to the Macintosh 
and PowerMacintosh hardware. 

Operating system developers need information about rite 
specialized hardware and low level driver software in die each 
Macintosh line. Until now, Apple has Ixen slow to volunteer 
this information, and this mailing list attmempts to address this 
problem. Since the OpenMac projects are dedicated to the open 
exchange of information and source code, there is little 
likelihood of signing non-disclosure agreements. 

The primary reason for this mailing list is to encourage 
discussion toward building better relations between the 
different OpenMac teams and those people interested in seeing 
die projects succeed. To this end, their goal is to maintain a list 
of specific information that can be presented to interested 
parties within Apple. Specifically, we encourage participation 
on the OpenMac homepage described below, and contribute 
your specific needs or solutions to the indicated problems. 

The list maintainors emphasize that it's not a discussion 
group for feature requests or software support in the OpenMac 
QSs, For such information, browse the Web pages listed at the 
URLs bdirw. 

To subscribe to the OpenMac mailing list, you need to 
send mail to ma jordomodpumaJ'tevdJ 3 Iadtsbu 1 g.va.us with no 
subject and with Ixxjy "subsoil x openmae" on a single line. 
After your mail has been sent, you should receive an 
acknowledgement of your request, and short guide on using 
the Ustserv. 

The primary online resource for the OpenMac ListServ is 
kicated at: 

hn p://pu im. bevel .blacksburg.VHA is/t »pe n mac/ 

More information on the MacLinux or MacBSD projects in 
general is on tlie following pages: 
httpt// nucleus. J bg. uu .se/macl I m ix 
hn p://www.nedisd( >rg/l\ ms/mac68k/ 

(Another) PDA Developers Conference 
Creative Digital Inc, publishers of PDA Developers magazine, 
Ls pleased to announce PDA Developers West a technical 
conference designed to give developers (hut art 1 creating PDA 
product# 

* an in-depth technical understanding of the most popular 
hand-held platforms ami their development environments; 

* a broad overview of third-party PDA development tools and 
products; 

* crucial information about what It lakes to succeed as a PDA 
software developer; 

* insight into wireless technologies and tlx* service providers 
that are looking for development partners; and 

* a glimpse* at new, exciting technologies that will have an 
impact on the PDA market. 

The firs! day of the conference consists of full-day tutorials 
on Magic Cap, GEOS, Newton, and Psion development. The 


second and third days include tracks nn wireless development, 
advanced programming topics, the business of software 
development, and new technologies, plus keynotes by: Kheng 
Jou Khaw, general manager, handheld computer division, 
Hewlett Packard, Singapore; Andy Seybold, noted wireless 
industry analyst anti editor of Andy Seylx>l d*s Outlook; and Jeff 
Hawkins, Chairman and founder of Palm Computing. 

There will also Ix* ongoing developer tools exhibits and 
demos all three days. To maximize attendee flexibility, there 
are separate registrations for the tutorials and die second and 
third days of the conference. PDA Developers West is 
scheduled for January 14-16, 1996, in San Mateo, CA, 
following the San Francisco Mac World Expo. Individual 
tutorials are $150 until Nov. 30. Conference registration starts 
at $J75 for both days, including breakfast and lunch. There 
are reduced rates for people who register for both a tutorial 
and the conference, student rates, and reduced rates for 
multiple attendees from the same company. Ifrxim rates at the 
Dunfey Hotel, where the conference will lx- held, Mari at $72 
for a single or double room. 

Further agenda and registration details am be found on: 
CompuServe (GO NEWTVENS, Creative Digital library), 
American Online (Compming/PDAs/PDA Devclopmcni/New 
Files), eWorld (GO NEWTON/Uama Lounge/Sample Code/New 
Files), and ftp://newton.uiowa.etlu/siibmtssions, 

kook for the files PDvWst96,sil and PDvWsi96.zip, or 
contact Creative Digital Inc. for more information. PDA 
Developers West '96 is produced by Creative Digital Inc., and 
sponsored by General Magic, Inc. Creative Digital Inc., 293 
Corbett Avenue, Sail Francisco, CA 94114* 
phone: (415 ) 621-4252, email: cdi©cdigitaI.com 


Peregrine, a Prograph Cuent/Servkr Development Tool 

Peregrine is a rapitl application client/server development 
environmeni built on the power of Prograph CPX, a visual and 
object-oriented programming Inaugae For the Macintosh* In 
addition to a sophisticated development environment. 
Peregrine has a full featured internal HQL database engine fur 
building standalone of client/server databases. Developers can 
create databases and applications without ever being connected 
to the target server. 

Peregrine is offered in two versions. The Developer 
version is $1495 and supports Butler and drF servers. The 
Corporate version is $2495 and includes connectivity to multi¬ 
user servers such as Oracle and Sybase as well, These prices 
include a subscription to email tech support and three CD 
ROMs containing upgrades anti information, Pktorius Inc. 
(800) 927-4847 
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It’s not just the basics anymore ! 

Advanced courses from Developer University 
get you up to speed quickly on new Apple technologies* 

LI OpenDoc 

□ PowerPC 

□ Newton 

□ Grapbics/Imaging 

□ Apple Guide 
Course* Available as 


W 

ScIMccd cJasstuotn Lecture 


Online 


Fur murr detailed information. check out ciur World Wide Web pages, 
hup www.infoappfc.com, or contact the Apple Developer University Registrar 
at (408) 9*-i-4fflT or fax \ 40ft) 9*4-0544 

Developer LinhmJiy. Apple Compiler. Inc l Infinite Luop. MS 30 MTU. Cupertmo, CA 950 H 


PowerTap''' 


The PowerTnp API brings distributed computation 
to your application and makes il as easy as a simple 
black box. Divide your job into tasks, submit the tasks 
to the PowerTap API and then request task results. 

Whether ifs ray tracing, chemical design, video 
special effects or number-crunching in another field, 
your computations can most likely lie done faster by 
muiiiplc machines. 

* Easy-to-use API * Thread Manager Enabled 

* Robust • Supports native, 68K and 

■ Compatible A4-based software, 

Emerson Kennedy 

Vy (800) 297-3888 

^ % powerlap# aol.com 



1*0 box 2530 • Redmond, WA 98073 


Open Tran jpon/TCP gopher//seedinq .apple am 

ftp^/seed if>q apple com/ess/pcbiic/mactqVM acT CP_[)ev^it 

Open Tra n sport a nd PCI http://pi lot. nj in.n et/ - m sprou 1/ 

PowerPC_ httpJfpow.gtobalnem.ojnV 

QuickDraw GX, Apple hnpV/www info apple tom/gK/ga.html ___ 

F andub hnp://aah residerKes.uiavai.ca/quidcgx/qukkgx.html 

Lawrence D Olivetm h Hp://Www 7 waifcaln.at. rv/kjo/gx/j ndeK.html 
QuickTime hTTp://quirklmTP,apple,cnin/devplop,hEfnl 

see also http://www mfo apple.cDm^dev/d^nfo/quidctime/quicktime.html 

Taligent http://www.taligent.conV 


Other Programmer Resources 

4D htip'JAivuvw. netf .orqy4d/4d. him I 

ACIUS ftp //ftp,dnai.com/pub/acius/ _ 

Ada ftp//ftp.seas.qwu.edu/pub/ada _ 

Animation Gass Library fTp://ftp.virtuafly.mcnet.chArirtually/ 

A f i p fisc r I pi f I p://qaea. kgs, u kans,edu/a ppl eser i p l 

hup://www.gc.com/scnptweb/ __ 

BMU Cl ht Ip //WWW. br 11 ug m y / 

Brian Bechtel htlp^/www infa.dpple com/dev/geeks.html 

Forth, MO PS Jerk fitlp://www.nE'tdxs.tom/-jayfar/mu[)s hmrf_ 

M OPS ftp: //laygeta.cK: nps. navy, mil/pu b/Forth/Mops 

Verk Itp: //flSTTO.uchicago.edu/puti/MAC/yefk 

fortran to C converter ftp://alumni, caltech.edu/pub/Mac F2G 
Free Development Systems Faq http:/tan^.eufOpa^^ 

Get 1 Resource http://www.ascl wMeduZ-haynes/gl r.html 

Grant’s CGI framework in C http^/arpp 1 carleton ,ca/ grant/mac/grantscgi/ 
Robert Lentz http ://www.astronwuedu/len u/mat/programmir^om^pcog hunt 

Lisp. MCL http7/www digjtool.com/ 

General http://www a.iochesieredu/u/rmlfcf/alu.himl 

MatHadt htl pi/ www.machack.com/ 

Mac Iech h tip://www mac lech. com/ 

Matthias Neeraclrer hUp://err ethzxh/memberyneefLhtml 

Matthew Xavier Mora http://)tavier,vi.com/umpg/umpg.hTml 

nick c (good lor beginning Macintosh programmers*1 http^/www.pilT.edLt/-nick/ 

Pars* CGI 05AX htlp://marquis.tiac.net/software/home.html 


Francis Pother 
also 

Digests archive 

Prefab Software 

ion Pugh (AppleScript) 

Paul Robichaux 
Source code, Apple 
also Apple 
also UMich 
also M, Neerarher 
Christopher Tale 
TtL 

sec also 
TopSoft 


http;//acae ia,em, tr :ftOSO/home/portier Andex.htm I 
news //comp, sys. mae digest 
ftpA/ftp.dartmouih.edii/pub/csmp digest 
h tip://www. tiac. net/pref a b / 
ftp ://ftp, ne icom com/pub/jo/ionpugh/homepage. him I 
http ://www. i nloworkshop.com/-jonpugh/defautt. html 
http ://www. fair gate, com/pau k sh tm3 
http: //www inf a apple xom/dev/devi nfa/macsou f cet ode, html 
http://www. i n f d a ppfe. tum/dev/sout ce/i ndex. htm I 
I tpi/mac, ar t hive urn it h edu/m ar /development/source/ 
1 tp ://hp,swi! ch P c h/sof t war e/mac/src/HTM L/Wekome html 
http://wo rId,std. com/’ naie/mae html 
ftp J/daemon. nesa, utuc ed u/TQ/ 
h ttp://rhi no.harvard ,ed u/dan/TC LArchive, htm I 
http://www topsoft org/ 


XCMD Hideout http://www.nmc.aulb edu/brendo^xcmdhideout/xcmdhideout, htm I 


Vendors, Products and Miscellaneous 

Absoft http;//www. absoft com/ 

Aladdin HASP http7/www,hasp.com 

Aladdin Systems (StuFfit) http i/www aladdinsyi.com/ 

Alpha (tent editor) httpi/www.cs.urnd.edu/-keleher/alpha.htmF 

BBFdit httpi/www.l iac.net/biz/bbsw/ 

Mac H ax Group http://www.hait.com/ 

tasilech vmual castings http://www caMpch.fi/ 

Celetfin http://www.celestin.com/ 

Ceneca (PageMiil) http://Www, ceneca.com/ 

Chris W. Johnson http://gargravarr.ee,utexas.edu 
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CJt hnp://Www,eitabs.org/ 

Cyno Technology http^/www.cyno.corn/cvm) 

Digitool http^/www.diqitodxom/ 

Dlfbon http:/^www unitedmedia.com^cofTiKs/djtljeM 

Draqlnsiall http://www sawrvconVdragimtali 

Tom Engel http://gayiet.med yale edterifwas/rttfnVMatimG^ 

Efogonomics Web hup://!uckef.roeth uidh.edu/ 

EduPage newsletter nidihodisipiQt^tftfticorrtedu 

m the body of the message pul subscribe edupage your name 
Evatat (PreditofJ hitp://www access^digexnet/ -evatac/ 

Graphical flusmevs Interfax htip;//www.gbi.com/ 

General Magic http^Mfww gcnmagic,oom/ 

Global Village Communication http7/www,qlobalvillage .com/ 

Iconix hitpJ/www biap.com/tconix/ 

http://www jasikxom/ 


Steve Jasik 
Just Some Guy 
Lanquaqe Systems 
FTP site 

LPA Prolog 

MIND/MacONS 

MatMagarine 

Macintosh Vendor Diredory 
MadinQ 

MacNel Journal 

Mac Netswitch 

Mac Nosy 

Mac Week 

Metrowerks 

Motorola 

NaviSoft 

Neologic 

Newton Source 

Newton 

PACE 

Pretoria fProgtaph) 
QKVSmaHtalk 


http://www spies, corn/gr eg/ 
http://www, langsys.com/langsys 
ft?y/ca& corn/pub/lantjsys 
http M WWW. Ipa co.uk/ 

I it tp ://tyber c tonx. tec hwood.org 
ht t p: / /oeon I ine, c om :8Q/ - tomk/M ac M agazi ne/ 
hHp; //www. maefaq. com/vendor html 
http ://Www . wsmitft. com/m adinq/ 
http://www.dgr.com/web mnj/ 
http://www.nd.edu/-dwalton \t 
ftp J/ftp, rwtcom com/pub/ma/macnosy 
h ttp ;//www zdne t com/ - ma eweek/ 
http://Wwwmetrowerks.com/ " 

http//www.mol.torTi/PoweiPC _ 

hltp://www.nav!soft. corn/i ndex. him 
hi tp Jl www. rwulogic tom/- neokigic/ 
hltp: //www. newtonsouice.com/ 
hup //newton mowa.edn/ 
ht I p //paceap,corrVpace.html 
hitp’i/l^,219.M.9S/home.htmt 
hnp^/www, qb.com 
ttp^/ftp.nrsus soft .com/pub/msus 


QUFD/M 

see also http://www,nisuS'Sofi.com/-ntsu5 

QuickCam http: //www. ju nglexofn/msatttcr/sd tech/comp/hardware/cpj ickcam , html 

Rainbow Technologies http://www.mbo.com 

RTFM Productions http //rampages.onramp.nel/-rtfm/ 

Semper R mailing list mailio:lisipfoc©abs,apple.tom 

in the body of the message put: subscribe SEMPER FI your mime 


StepUp Software 
Summit Software 
Symantec 

fenon (Madlien Unix) 
TidBITS newsletter 
see also 
to subscribe 
Time Tracker 
The Ultimate Mac 
UserLand AutoWefe 
Verb Finder 
VIDI 

The Welt Connected Mac 
Working Software 


hit p ://r arnpayes onram p.nei/- siepup/ 
hi tp://www .s urnmsoft. com 
hi tp. //www.symamecxom/ 
http:// www. tenon .com/ 
hitp://www,dartmouth.d^ 
news ://comp. sys, m ac digest 
ma iho: inf o@tidb its. com 
hnp^/www maui.com/-tellm 

http :/Avww. fr eep ress. com/m yee/u 11 i mate mac. h tm 1 

http://wwwholwited.ccjm/Staff/userlancl/ 
ftp://gaea kgs ukaiis.edu/ffontJpr/aldsluTf/VerbStack m ,hqx 

http://erehwon.caltech.edu/vidi/vidi-homepage.html 

h np://wwwniac faq.com/ 

hi ip.//www weixom. com/-wocking/OEM html 


Visit MacTcch Magazine's Web site! 

http://www.mactech.com 


JS&i 


ScriptWizard 


Version 1.5 

Now shipping. With all the new features thai you asked for. 

Sen pi Wizard 1 * 1 is the best-selling GSA/AppleScript script-editing 
and debugging tool that combines the power of a professional 
development environment with the ease of use that you expect of 
Macintosh# software. ScriptWizard Improves your productivity by 
delivering testing and debugging facilities that -ire as intuitive its 
they an* powerful, including a Variable Watcher, true single-step 
debugging, rapid script navigation, and more. 

New features... 

* True AppleScript statement-level single stepping. 

* Scrtplablc and Reci inlaid e» 

* Improved text editing* with dr-ig Lind drop 
*°Nal ive u for both Power Macintosh ami 

* Quick access to Dictionaries from .* new menu. 

* Full control over Toolkir posit inn & visibility. 

* Re-sir a hie panes in windows. 

* Prnjerrof'aware hu source code < ixittd- 

* Edit and debug scripts for Face Span 2*0. 

* and much, much, mare— 


Upgrade 

$39 

US price 
still only 

$99 



IIS Orders: 800 232 1560 

Tel: 510345 6434. Abo»»U by APL1A & MacTcch. 

Full Moon Software* Internet: .vifes^tidiiiiixui.LtuiF 
lnhTii.itnm.il Orders: Tel *44 1628 660242 . Fax 666084 - 




Can you spot 
the difference? 


Plenty of people nmt bemuse whether you update software with a 
full sei of program disks* or a file made with llpdaieMaker 2 t the result 
is die same. Guaranteed, UpdateMaker updates are totally reliable 
Its system of 32 bn checksums ensures that it updates the right file 


Ami 1 TpdatrMaker is ettsy-to-u$e - simply specify the files and 
TpdileMaker builds the update There is no scripting or use of 
Res Edit. It's even easier for end users just one button to press, 

UpdateMakcr 2 works with any type of Macintosh File. The updater 
files ate extremely compact And the program (iptions numerous 
You ran preserve or override user custonrisatioos. Save files in binhex 
formal, I IfxLitc up to 20 old versions with one file 


The real difference is the savings in rime and money Which 
explains why some of the best known names in software 
development have already discovered I pdateMaker 2. 

Distribution is unrestricted and royally-free. 

Only $225, order now, fax (415) %4 2886 

AMiktiulvMad *klRKF 1 niCTm-UMv-'t^lRXP # AppkLiuLAppk.LTJiu 


© 


UpdateMaker 2 


ADIiiMniiikiUs 2225 Grant Road, Suiie *4, Los Altos, CA 94(124 Phonci (415) 964 28^8 
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MacRegistry* 



Work in 

Developer Job Opportunities 



Vatationland! 

If you are a Macintosh developer, you should register with 
us! We have a database that enables us to let you know about 



YOU DON'T HAVE TO LIVE IN THE URBAN JUNGLE TO 

job opportunities. When we are asked to do a search by a 
client company the database is the fust place we go. There 



00 WORLD-CUSS PROGRAMMING FOR EXCITING PRODUCTS! 

is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 



A financially strong, rapidly growing software publisher, located in the heart of 



"America's Vatationlamf/ is seeking strong C programmers 

Marketability Assessment - To get a specific feel for your 



wilfi experience writing commercial products for Macintosh. 

marketability send a resumd via Email or call. You may also 
request a Resume Workbook &. Career Planner. 



In addition la a competitive salary and benefits, and challenging, 

Discreet - We are very careful to protect the confidentially 
of a currently employed developer. 



high-profile work, you'll enjoy the chance to live in u beautiful, low-cost 
communily just a shod drive from some of the nalions premier sporting 
areas and reset Is, Live where most people only gel to vocal ion. 

Scientific Placement is managed by graduate engineers, we 



enjoy a reputation for competent <& professional job place¬ 



To apply, send resume in confidence to: 

ment services and we are Mac fanatics. 



Mark Swanson, Vke President, Software Engineering 

1-800-231-5920 * das@spi.eoni * Pax 1-800-757-9003 



Advantage Learning Systems, Inc. 

http://w w w*sc ien li fie.com 



P.0. Box 8036, Wisconsin Rapids, Wi 54495 BQ36 

Scientific Placement, Inc. 



ADVANTAG E 

MT t Am tTO4*r, Ucaaon. TX 77224. 713 4M4100 Pat 71>4964B73 

MT Hm 71. Raimm. CAW5K5 5 ID 733 61 ft# bttfa*«faaJafc com 

Mf, Hm Auiim. tX I*?2a2ft7ft 512-26041123 fcjftzifterjKl 



Learning Systems. Inc. 

Ml. kpniiH*? VUtirm, Hm 1S2LY ftnlwl. *1A 022 IS frl 7-(24-8l37I jCHSB^ fedi-pfLCafii 

V Aprtrt4Jil( 111 VUI. iVifryuwrvc 71114,1.5001; eWorld: tpt AOL: daveunall 





MacTech Magazine 
is your 

recruitment vehicle 

When you need to (ill 
import am positions at your 
company, MacTech Magazine 
is the consistent choice of 
companies across the country 
for hiring the best qualified 
Macintosh programmers and 
developers. Let MacTech 
Magazine deliver your recruit 
rnent [message to an audience 
of over 27,000 qualified 
computer professionals. 

fall Ruth Subrin at 
805/494-979? 


Do you have a service that you want to advertise to over 
50.000 Macintosh programmers and developers? 


Do it m the MaeTedi Magazine Classifieds 
an inex|xnsive vehicle El nit gpts nvulLs. 

Gill lOilli Siihrin al HUS/ 191*9797 to rowTve spare NOW! 



The Trattner Network 


The Trattner Network, a digital talent source, is looking for 
experienced Macintosh developers for a variety of consulting 
opportunities, Current projects include development in the areas 
of OpentHie. Newton. Power PC. Melmwerks. PowerBimk. 
MacApp, 11) anti many others. 

We have urjynU needs fur: 

■ Software IVvdopcrs 

* 11a rdw.ire/llrmwa re Kngi neers 

* QA/QC l Prt jfessk >na fs 

* MultiMedia Developers 

* Project Ox >fd i nator/Ma nage r 

* Nit work Professionals 

The TraLiner Network Brings 10 years experience in the 
Macintosh consulting and placement industry', offering a unk|ue 
blend of humanistic interaction and technical knowledge. 
Positions in Nufiltem California ami Nationwide. 

If you are kxiking for the chance to enhance your skills, team with 
the Ix^L and make lots of money, send, fax or [ink your resume to: 

TTN 

Attn: Nyta Miller 

17U Stale St. F Suite 210, Las Alias, CA 94022 
Flu me (41 *>) 949-955^ ■ Fax (415) 949-1026 
AppleLink; traL.nd * email: nmiller@lnitnei coin 
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Career decisions can live with you forever. 



fith degree software 2 financially strong, rapidly growing Macintosh developer staking out a leading position in 
desktop publishing and multimedia enabling application*. We're the creators of Proteus. "The Magazine Architect’, 
which one of America's largest publishing companies has called "the most brilliantly realized publishing system since 
Quark Xpress.“* (Check out the lead story in Mac Week's 9/10/95 GA section). Our headquarters ts m the heart of the 
Toiyabe National forest in income tax-free Nevada, just a short walk from Lake Tahoe and minutes from Heavenly and 
other Sooth Lake attractions. If yotiVe interested in an exciting work environment, an excellent compensation package, 
and great opportunities for personal growth in a beautiful, family-friendly community where most people only get to 
vacation, we’d tike to hear from you immediately Positions currently available include: 


Principal Software Engineers - Senior Software Engineers * Software Engineers 

These technically -inti .uwlyinally chdlengmK powborw. with rvqMntitMlity for creatnig .ind enhancing higfvpnnfilr 
4ppikAfhans* rrefuirt flurnry and deiunmn.ihlr rwperlmrr* nrvrii iping rismnwlrtl [Wforh In non of 

rhr Inflowing fomaworta (m order pfpnrfmHfK# M.itApp Jx Muirtywurkk tawed tail, or 1 fotik Qua Library 2*. 

Technical Support Managers • Technical Support Analyst* 

Ihese positions, vnpi mspowwtidity to end-mri tram mu and 4ppicjtion support require dcmar^rablt 
exponents m pUiltutian Lynligur .iliyu 41 »J |xodoct«wi. pi den ably 4 l to HioOul faun Mavigcr level o* -iwve 
These powliom alio call to 4 dc#*c of Urrulunty with to i/v of Syslrm 7 ,% jto Marmlosh 

AppSnttto*, «xh as Quark Xprevi, Paflfm.ilU'r arwito ftw^mSop Some of to.r pcrjitov, .in? avatfabte .11 
our inuring lanbiy m die New }crxy juM uuistor ol New York Uly 


Regional Account Executives 

Thr-*' prwXinm, vwlh pr“^vw«t)iii<y to **11^ Irni rnr^l.xr 1 .nvl m.uniivsiniff' irfjuH-r fafl WWv C 

expenerre in fwijfvtl -toltv.vr c»k?s nk'.iUy i» tkent* ti the puUshtpg mdinlry or mtilnJ sector’s 


i 


Due to the immediacy of our staffing needs, we encourage you (or a friend) to send 
us your resume today, indicating the position of interesL by fax (702-588*4901) or e-mail 
(nthdegree@sierTa.net). If you are driven to achieve, well take your career to the nth degree. 


Dilbert by Scott Adams 
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Tips ami Tidbits continued [front pa ge HO 




Build a menu using (he MDEF and 
then just handle menu selections like any 
normal menu . 


is a collection of five menu defini¬ 
tion resources (MDEFs) that you just 
fkiste into your project f s resource fife. 


Also contains Maitre d\a special menu devehmenl tool 
that assists you in designing your MENU MILL Menus. 


Im i IKM.VI IVI CuitSORS 

One technique that I have used in the pas where dropping am 
the debugger wasn't an option, and jogging wasn't getting 
flushed in timc/took too long, was to create a bunch of cursors 
numbering 00 - 99, and made a cal! to set the cursor and return 
the numl)cr of the previous cursor; 

routine 1U 

< 

rrhort olifCursor * fsetOdKffcCunjarO 51; 

(void) fietDebugCursortoldCuriory; 



* Use your drawing programs as programming took 

* Fast unobtrusive RGB color picker 

* Space saving C*eneva 9 MDEF 

* Calender Menu 


JUST* 


$69.95 


Write, Ariel PublUMnjt, Inc, 
11A Leisure Time Drive, 
Diamond head. MS 39525 

Call I60D 255-6713 
FAX (6011 255-7086 


Ol VI .rot'l li IIV SIASCKOFfWAItt. INC* 



Whul the tripling Gurus Say About 
Script Debugger 

fapf ** ond db $ mhx* 

SiwtOehti^tf hmrnlmTOMm. IS 
pai#imarimi**4jciek 

wAco^fMlf qppwx* 

Ww i(U. wtOm mi 109114 uferwr 

7 vx kopt fofegger & mr 

Irfito Odtf ti rj fljjjy WT^/i^CTUjLlif 1 IttpauAfli* 

fa p*ym'i ynptsUbtf and attohMy m 
ftmm ndi ti tnhntoly mhmvobk ' 

J* PugK AftdrtnM ^**>**• mtim «l lw i (nmntft 


*129 


Lde N>ghi Sdfwie lid. 
Voice (604)929 5576 
Fox (404) 929 4961 
E-mail giubti^witTrscy corn 


Script Debugger 

Scrips Dchn^cr is a powerful and fkubfc AppleScript- authoring tool that makes 
it easy for novice and capencwced senpt enters ki gel the mosi from ApjtleSrnpi 


Script Debugger 

■ Offers true single-step exefuticm of 
flH AftdcStnpf stfipts 

■ Provides o powerful tfrpfmg enwon 
merit that includes Drug ft Drop editing 

■ Is Power PC Hunve 

■ Is suipteble and uitaduible 


This way when llie machine froze, the cursor would tell me 
whal routine it liad frozen in. 


Tom KtmpHm 


MFW Editor Primitives 

(“he MPW Command Reference describes 52 editor primitives 
which may be attached in any key sequence using the SetKey 
command. While the SetKey command itself is useful, the list 
nf editor primitives alone is useful to MPW script writers. 

Though only documented for use with SetKey, editor 
primitives may be used like any other MPW command; in 
scripts, command aliases, or AddMenu items. There are a 
couple of advantage# 

1) They only work on the active window and have sharply 
defined functions, you don't have to rcmcmlicr any selection 
expressions or argument lists. Compare; 

HoveS t ur tUf Ki1 e 
with 

Find * *1 Acti ve I* 

2) They're fast. I haven't (Hit a stopwatch to it. hut you can 
see the difference immediately in running a script that uses the 
primitives and one that doesn't. 

The MPW Command reference lists tliese 52 primitives, the 
names of w hich should lie self-explanatory: 

DdeteOiarhefi 

Octet eCharRight 

DeleteEndOfMle 

DrieieEndOnJne 

DekleStartOfFle 

DekteStaitOfline 
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DeleteWordLefi 

Del etc Word Right 

MoveCharLeft 

MoveCharKight 

MoveFndOfLinc 

MoveLineDown 

Move Une Up 

MtivePaguDown 

MovcPageUp 

MoveStartOfPiie 

MoveSrartOfUne 

Mo ve Word Lef t 

MuveWordRight 

NdectCharleft 

SdaiCharRight 

SdectEndOfTiJe 

SelectKndOfline 

SeteaLineDoWn 

SdectLinel IP 

SdectPagel )ovvn 

Select PageT Ip 

SdectStartOfFiJe 

SdectStartOfLine 

SelectWordLeft 

SdcrlWord Right 

There are also at least live primitives that aren't in the 
com mu nd re fere m;e: 

Scroll End 
Scroll Home 
ScrollPageDn 
Scroll PageUp 
Deb uggerGt>m ma nd 

1 can understand why Apple might not want users to 
casually drop into Macs Bug from an MPW script, but I wonder 
why they chose not to document the scrolling commands? 
Whatever the reason, you should obviously use caution when 
playing with undocumented features. 


Lee David Rimar 
A hsoft Corporation 




Bug Tracking the Macintosh Way 


Tcs[Truck automates and simplifies tracking pur bugs so you 
can concentrate on fixing them. Easy to set up, easy to use, 
and quick too! 


& Track bugs, change requests, testers, 
configurations, and mom 

Produce 1 concise reports and charts 
& Automatically route bup^s to leant members 
& Minimum setup time 
& Multiple users, full security 


Available in September 



far more Hifoimihoci, rjit or *errl e-rrail to seaprari^cnwifiPf 


line 

ware 


Vaplitr lac. 

10&6 5c jpinc Court 
MoiriwkjiH ^AVV 


MultiQuest S-CASE 



The Clear Choice for 
Serious C++ Architects 


Tafw control ul your C++ tfeYi?kipmcnl with S-CASE, a puwcrlut design environment 
for today's demiintiinK appbci*lum;s Vteurtlm? rixiuia-tnet^ using the Booch 

nutation. CktUTatcC * *■ codoautomatloiliy imm your ckaipi. Keep your model* and 
code* in perfect sy richnunr/.i I ton C.ill for ymrr frtt drinfi disk ami find out why cum- 
panitw tike Molomta, Sierru'm. dmJ Amoco rely on SCASFL 


Key Features; 

* Boodi notation (1994) 

* Real li me rule checking 

* H endive C++ code generation 

* Hierarchical project manager 

* Mulll-user 

* Multi-platform 

* Check in / chock out 
■ Color support 


Benefits: 

- Rapid protuly pir il| 

* Gleaner architectures 

* Reusable designs 
Platforms: 

* MnrintoKh 

* Windows 

* Sun SFWRC 

* HP 9000 



Phone (708) 397-9930 Fa* (708) 397-9931 

E mail 72531.251D ft CompuServe, com 


Novkmbk li 1995 * MacTe<:hM a* ; azi ni: 


Tws & Timms 


67 




























Yivujxrint a mi timed from fKige i 


The Mie s .1 lr>y H right? Fine, ask them, *Whai kind of toy 
builds products like Adobe Photos! top? What kind of company 
uses Madmosh m build products which cunlribulc to a $598M 
annual revenue cash flow?" Coal miners riding in coal cars 
(*Got a PC? You muM he unenlightened.’}, dumb dads 
configuring a PC (how many millions of PC users are going to 
believe that they're really dumb if they have a PC that gets the 
jol> done?), and a crazed msinkir taping an 800 number up on a 
glass wall (who knows what this means!?!). Could really smart 
devciofXTN who build tremendously great software and make a 
gazillion bucks lx: any worse? 

Trivia Errs 

Why is Ticks one of the worst low memory global* to access 
directly on the Power Macintosh? Hint: is S16A divisiWe by i? 


Food For Thought 

‘Remove these items Ixxattse they can cause dutier and use a 
large amount of memory, QuickDraw GX and PowerTalk/ 

- from a product installation guide 

♦ 



This could 

be a best 
seller. 



But 

it's 

free. 


You can’t buy the Consumer Information 
Catalog anywhere. But you can send for it, free! 
It’s your guide to more than 200 free or low-cost 
government publications about getting federal 
benefits, finding jobs, staying healthy, buying a 
home, educating your children, saving and 
investing, and more. 

Send today for your laLest free Consumer 
Information Catalog. The Catalog is free. 
r fhe information is priceless. 

Send your name and address to: 

Consumer Information Center 
Department BEST 
Pueblo* Colorado 81009 

A public service ol this publication and the Consumer Information Center of 
the li.S General Services Administration 
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MAIL ORDER STORE 


MACTECH MAGAZINE PRODUCTS 
& ORDER INFORMATION 


F-maii, Fan. write, itf call its You rrwy use ym»r VISA, 
MasterCard or Ametx*iii taprera; nr you may send dieti 
iif nutocy oulcf (m IIS funds only): 

Mac Tech Magulne, F.O Box $2(10, Wot lake Village, CA 
91559-5200 • Voice: 8^194-9797 • 

ir ytiu an* an c-rmlt user, ymi can place orders or 
contact customer service ui 
- AppleLink MT.CI i5TSV< 

• CompuServe: 

■ Internet: i astecrvuctfxplam cx»n 

• America Online? MT CUSBVC 

■ GEnlca MACniGlMAG 

• eWorld: MTCumSvc 

StUSOUFllUNS 

IS MaKa/Joc $47 for 12 tesue* 

Canadian $59 for 12 Issues 
International $97 for 12 tames 

US with Nogrivtiide Dusk $124 lor 12 lsmk s 

t bruclLin Ifegatfrc w Source tide Disk. fur i2 «shl* 
Irntmaxirul ktitfa/mc w/Sounr (axle Disk: 5194 far 12 issut* 

CD-ROM 

StocTceh <J>ROM, Volumes 1 10 1m hides catt 1250 
articles fmm alt 115 iwue* {\ W 1991) of MacTceh 
Magazine 1formerly Mac I’uloD AJI afrtrif hm and *cwive 
code. Now in THINK Kdennee format Tire CD rndudo 
%uianrcc $ THINK™ Hefenwe 2.0, wt jriunj! ajiptiLatoJiis 
with lull ikicumematinn, pnrkxl demu^ fur dmTuptfs and 
mow See at hertlwmei ft. dito sauc: $49. Upgrjdev$39 
F -mail. call nr write fur No. 

BOOKS 

7to j /itetf of ,\hu Tutor, Volume 1 St 411 )\ it 
The OMfjkte MtmTutor, \\ 4urn 2: Sold t >i ii 
7 be Bxsenttal Mac Tutor Vol iime 5 $ 19-95 
The Dojhttttw Mae 7 uhtf, Vdume 1: $24 9S 
The Ben itf lfaemor, Volume 5: $54/25 
/*x/ ifMtvrhib tr ( kifea k ki Volumes 5 - 5: $t& 

Ben tif Mat iltlor, Volumes 6, 7, 8 9 Nut available 

DL4KS 

Source (aide Disks: %H cadi 

T<ipha! 1 ridcx O98H9911 on disk $5 

MAC AZIN I RACK ISS1B 

Volumes 5* 4, 5, 6*7, 8, 9 amt 10: $5 earh (subject to 
avaUabftfty) 

California residents irulude H 2S% sales lax on all 
softw are, dhb and InxA* 

Atkav up ti 2 wsrks hr ganlml uktntstr outers. mure time 
fox mtimtisrul meters 

RIF ASF NOTE 

Source code disks and |nurmk ftijm MatTtdi Ma^^tone are 
bncnvd to it*' puntu^T fur pm ate use only ,uxJ are noilnhc 
Oyued for a ot uo il ^to \ I iowever, the code ecjntimeri 
tlierem nay I* mUuufcd, if jwoperiy nckw iwktf^tl in 
uuiumen ul penttocts al m iKkbtmcttl chap? .All prkm m* 
sulsfc^ct Hr dunp wrtlxwi nttia% 




3RD PARTY PRODUCTS 


MAOtOl FJU Li SIVFA 


Macleclt Magazme m your exclusive source 
for these specific products 

Ad Lib 2.0 The premier MacApp 3,0 cornpulibte 
ViewEdit fcplacemenf A powerful user-inlet lace 
editing fool to build views lor MacApp 3 0 and 3,1 
Art I lb atlrws subclassing of all ol MacApp s view 
classes including adoroers behaviors, and drawing 
enviroismenis String and tax! style rtsourcts are 
managed automalically AJtamide display methods, 
such as a view hierarchy window allow easy 
examination of complex view stmefures Ad l ib 
innludes source code for MacApp extensions Ihal am 
supported by the editor buttons can ne activated by 
keystrokes, behaviors ran be attached to Ihe 
application object, and tjtmaI purpose behavtms 
can be configured lu perfotm a numbet of useful 
fundiofis. Hun mode allows the user to by out the 
views as ttiey will work m an application Templates 
can be created lo add additional data fields Lg view 
classes Ming palettes provide tasl and easy editing 
ol common object and allnbutes Works with ACI’S 
Obtfict Master (vetsion 2.0 and laid) lo navigate a 
project s use* inieftace source code $196 

Frameworks Magazine: $B/back-issuc 
subted lo availability 

Frameworks Source Code Disk: $10 

per back issue, sutojed to avaitabilily 

Five Years of Objects CD-ROM: 

archives and source code from April 1991 lo January 
1993, plus selected otiject-unented publtdy available 
software and demos $9b 

MAD AGON *93 CD-ROM: Ihe Ingtiliylils ol 
MADACON ’93, including Mike Hotel on Fink. 
Bedrock. MacApp, GGUls. and more Slides, articles 
riemns, audio, and QuickTime $96 

MAScript 1.2 adds support toi AppieSaipt 
to your ManAppao 1 and 31 based applications Make 
your application scriptable and recordable by building 
on a tried and tested framework tor object model 
support MAScript dispatches Apple events lo the 
appropriate objects, creates otijed speakers, and makes 
framework oblacis like windows and documents 
soiptabte and mcurdable Sample aopticahon shows 
you how to begin adding support for scripting and 
recording MASoipi indtides complete source oxte 
Install MAScnpi by moditying one MacApp souioe file, 
then adding aratf» to your prup2 Tutere versions of 
MacApp will incorporate MAScnpi, so MAScript 
supfxidyouaiJdnuwwillwOfkinter! future %W 

The Mjoiner BETA System is a software 
devdopmenf environmenl suppurlmg objed-oncoted 
programming in the BETA programming language 
BETA is uniquely expressive and orfhogonal BfclA 
unifies just about every abstraction mechanism - 
including class, prncedum, function, coroutine, 
process and exception - into Eta ultimate abstraction 


mechanism Ihe pattern BETA includes genera! 
block structure, strong typing, wholn/part objects. 
The compiler binary code generation, automatic 
prbage cofteclion, separate comprlalion, interlace to 
C, Pascal, and assembler The system persistent 
nhjRcts. basic libraries with containers classes, 
plallormHrutependent GUI application frameworks on 
Unix, Mac and Windows NT, metaprog ramming 
system The tools available on Unix Ihe hyper 
structure nditnr supporting syntax directed editing, 
browsing, etc,, ami Ihe source code debugger are 
currently being ported to the Macintosh system The 
Mtolnef BETA System for Macintosh requires MHW 
(basic scl) 3,2 or later Package containing compiler, 
basic libraries, persistent store. GUI Iramework, and 
comprehensive doainenlalion (Other packages are 
also available) $296 

More Savvy includes all Savvy feauresplus 
Apple Event support foe all sub-classes of 
TFvemHandler with extensive view support Apple 
bvenl support for lex! includes ted athibutes and sub¬ 
range specification temrtahilily aoporte addibonal 
actions, and coercion includes additional lypes 
Addilinnal dinnl and server Apple Events $450 


NEW Version! 


Savvy 1.1 0SA support 
includes altachability, 
rccwdahility. scriplabildy. coercion, m addition to 


script execution, idling and i/to Apple Event support 
Includes complex object specifiers, synchronous/ 
asynchronous Apple Event handling, and Apple Event 


Iransadions tor clients and servers. The Core Suite 
of Apple Tvcni nhjects is supported including the 
application, documents, windows, and flies. 
Documentation includes technology overview, 
cookbook, and sample code $250 Savvy uow 
supports MHW 31, 3.11 and continues lo support 
3,01. as well as supporting Melrowerks CodeWarrior. 
This monlh only, special offer - All Savvy 
versions include Iree copy 0# Savvy QuickTime! 


Savvy QuickTime Requires Savvy. Mom 
Savvy, or Super Savvy Includes QuickTime, Apple 
Event, and view template support Movies come out ot 
Ihe box ready to play, edit, and react to Apple Evenls, 
They can be included In any view struduifi, including 
templates, and are displayed m ita scrap view Movie 
controls include volume, play rale, looping mode, 
dispiav stvfe, ami i4iiei diaracletistics $250 


Super Savvy includes .ill Mom Savvy tenures 
plus compile ndil, and record sen pis using built in 
script «teor View tenptate editors, like Ad Ub, can 
attadi scripts to view objects and modifted scripts 
are saved with the document Script action behavior 
allow quick access for executing and editing scripts 
attached lo views Text to object specifier coercion 
plus mom $700 


MtuTech Magazine Is your exclusive source 
tm available hack issues at SfA s magazine, 
source code disks and assorted CD s, Celt 
tor mare info and pricing 


NOVI’MBKK 1W * MAfTWJfMA(iAZINI , ‘ 


Mai i Ountvit Smuv. 
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BtX>KS 


Learn C on the Macintosh ny Dave Marx This sell- 
tocTrring tonk/tirsk package gives you everything you need 
to degin piogranrmng on foe Macintosh learn to wile; afrt, 
compile, and nn your first C programs forough a series ol 
over 2S proKsrtn mat tRrild on one anoldei The book cornE 
with THIN C - a orstomired version of Symantec's THINK C, 
the leading progiammiriy environment tor Macintosh 464 
pages, Book/disk M $31.45 

Macintosh C Programming Primer Volume 1, 
Second Edition, Inside the Toolbox Using 
THINK C by Dave Mark and Cartwright ted This new 
edition of this Macmlc^li programming bestseller is updated 
to include recfmt changes in Macintosh technology. 
Including System 7 , new versions ol THINK C and ResEdit 
and new Macintusti machines Headers will Icam how to use 
toe resources, Macintosh Toolbox and interface to create 
stand alone applications 672 pages, mm $24 25 

Macintosh C Programming Primer Volume 
II, Mastering the Toolbox Using THINK C by 

Dave Mark Volume II picks up where Volume I leaves off. 
covering more advanced topics such as: Color 
QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager 520 m $24,25 



NEW! 


Macintosh 0LE2 Programmer's 
Reference: Working With Objects: 


Provides a complete reference to die extensible protocol 
ol Object Linking and Embedding, version 2 01 tor 
Macintosh System 7 Understanding of C/C* % helplul. but 
not necessary, and comes with a CD Working With 
Objects describes the visual arid Jnteractice interfaces that 
supped I he aHiipnrwnt objects. provides details of die 
Oli 2.01 for the Macintosh user interface. addresses toe 


issues ol object class registration, shows how to 
implement toe drag and drop objects from one application 
to another, covers the interlace that exposes Ihe basic 
entering functionality, and includes descriptions of API 
functions 4444W* $40.45 


C For Dummies, " Volume 1 by Dan Goodwin 
Finally* A hands-on, Step by stop tutorial for learning lire 
essentials ol programming In G. $17 95 

Macintosh Pascal Programming Primer 
Volume I, Inside the Toolbox Using THINK 
Pascal by Dave Mark and Cartwright Heed This tutorial 
shows programmers new to toe Macintosh how to use die 
Toolbox, resources, and the Macintosh interlace to create 
stand alone applications wild Symantec's THINK Pascal 
544 pages mm $24.25 


FWWI Mastering the THINK Class Library 

“■ by Richard Parker Now that Symantec's tong 
awaited PowerPC native compare is here, developers are 
taking another look at THINK This book provides a 
thorough exammahnn ol Symantec's extensive Class Library 
and the Visual Architect, a graphic user interlace 
development tool that allows you to produce commercial- 
quality aptHusslMim wiiti a -rmnnitirn ol elfori A complete 
dmtohonnJthc structoreandopentoioltoe ICL indudes 
explanations of all code generated by toe Visual Architect, 
any necessary custom code, and the operation ol tots code 
Visual Architect tutorials provide you with a step-by-step 
approach for simplifying die development of complex 


Macintosh applications 496 pages t3Mft $25.96 


by IMS R. Carter 469 pages mm $24.25 


C++ For Dummies " by Stephen R Oavrs is the all- 
in-one referents dial gets you comfortable with objed 
oriented methods and up and running doing C++ 
programming* I4W& $17 95 

Leant C++ on the Macintosh by Dave Mark After 

a brief refresher course m C, Learn C++ iralroduces toe 
basic syntax of Cm and object programming Then you'll 
learn how to write, edit, and compile your first C++ 
programs through a senes ol programming projects that 
build on one another as new concepts are introduced Key 
Cm concepts such as derived classes, operator 
overloading, and ioslream Tuncliuns are all covered m 
Dave's easy-to-follow approach Includes a special version 
of Symantec o+ lor Macintosh Bouk/disk package wijh 
3.5‘ 800K Macintosh disk 400 pages, $33.26 

Programming Primer For The Macintosh 11 

Volume 1 by John Whittle and Judy May This book 
provides an introduction to Macintosh programming, 
using Cm as the example language, and provides 
realistic, easy to follow, programming examples designed 
to work with either Symantec* C++ or Metrowerks* 
CodeWarnoc 6* Also Includes one 3.5“ disk with source 
code tor the programming examples, along with 
numerous, useful, pubic domain utilities lo use with each 
compiler Um $34.15 

Programming in Symantec C++ lor the 
Macintosh by Judy May and John Whittle This book 
will introduce you lo ubjed-orterted programming, the C* i 
language, and of course Symantec Cm fur (tie Macintosh 
You don't have to be a programme, or even know anything 
about pi ugi an lining to benclit from this book Programming 
m Symantec C++ for the Macintosh covers everything from 
toe basics to advanced features nf Symantec C++ ft you are 
i Think C or ftxteci \ C++ prognimmef who wants lo team 
more about object-oriented programming or whaTs rtffcronl 
about Symantec C++, them are chapters specifically for you. 
includes helpful examples of C+»code IM illustrate object 
mniBtf programs mm $26 95 

Symantec C++ Programming tor the 
Macintosh, Second Edition by Neil Rhodes & Julie 
Mctehan ts the paled introdudron lo C++ programming 
- the most popular programming language lor toe Mac 1 
This updated edition is the easiest way to learn C++ in the 
think environment, using many examples and hands on 
coding experience Tim official Symantec book, developed 
in cooperation with toe Product Development stall 
Provides valuable solutions, Irrtmmatlon, and advice for 
MPW programmers who are migrating to the Think 


PWW1 Global Interface Design, A Guide to 
UAm Designing International User 
Interfaces by lany Fernandes* AP Professional 


Global Interlace Design addresses the issues involved in 
product development lor a global market with a “real 
world" focus White covering major areas developers 
should address during the development cycle, Tony 
Fernandes provides Insight into researching cultural 


differences This book examines the differences found ail 
over the world, such as cultural symbolism and taboos, 
and how tony impact user interlaces $32.35 


Taligents Guide to Designing Programs: 
Well-Mannered Object-Oriented Design in 

C++ Is the taJigeat approach to object-oriented design. 
The Taligenl Operating Environment is the llrsi 
commercial software system based entirely on object- 
oriented technology, laligent’s Guide to Designing 
Programs is a developer s eye view ol this system. 11 
introduces new uuropte of programming and empowers 
developers 10 create software more productively Out of 
their direct experience in developing the system, the 
authors locus on global issues of object-oriented design 
and writing C« * programs, and the specific issues of 
programming m the Taligent Operating Environment 
Tatigcnt's Guide lo Designing Programs assumes the 
reader is an experienced C++ programmer, and proceeds 
from there to fully explore *the Tangent way* of 
programming $17.55 


Software By Design: Creating User Friendly 
Software by Penny Rauersletd (Senes Editor: Tony 
Meadow) This cxcellrmfl reference provides readers with a 
Ihorouyh how-to fnr designing software that is easy lo 
learn, comfortable lo operate and that inspires user 
confidence Written from the perspective of Macintosh, 
but compatible with all platforms Stresses user mpui 
horn initial design, through prototyping, testing and 
revision Provides tools for analyzing user needs and last 
responses Includes exercises for sharpening user* 
oriented design skills mM $26.95 


Macintosh Programming Techniques ny Dan 

Sydow (Series Editor Tony Meadow). This tutorial and 
handbook provides a thorough foundation in toe special 
httbnfoucs of Macintosh programming for experienced 
Macintosh programmers as well as those making toe 
transition fiom DOS Windows, VAX o< UNIX Emphasizes 
programming techniques over syntax for belter code, 
regardless nl language Guides the leader through Macintosh 
memory management QuickDraw, events and more, using 
sample program in C++ Disk includes an interactive tutorial, 
plus reusahto C++ code $31.95 


environmont Disk includes source code hum the hook and 
example applications M $40.56 

Teach Yourself Mac C++ Programming in 21 
Days by Namir Clement Shammas is the easy-to-failow 
21-day format teaches readers how to program in C++ 
using the Symantec C++ compitef II also shows i eaters 
how to develop GUI applications using toe fetes! version 
of the THINK Class Ubeary (TCL) Targets Symantec C++ 
7.0. one of the hottest programming languages and 
development environments Discusses toe basics ol 
programming for Ihe Mac using TCL and the Visual 
Architect utility Uses notes, tips, and warnings, as well as 
05A. Quiz, Exercise, and Do/Donl sections to teach users 
the Ch programming language P+ 4 ^ $26.99 

Writing LacaJizable Software for the Macintosh 


Macworld Ultimate Mac Programming by 

Dave Mark Bestselling Mac programming author Dave 
Mark reveals Ihe secrete lit Mac programming and presents 
important. hiTiesdvtngte.iinigtje's $35.95 

Mac Screamer The Ultimate Macintosh 11 

Supercharging Kit by Jan Harrington cavers 30 
Macintosh models, including Ihe Classics, LCs. 
Power Bonks, and Quadras ami gives software solutions 
and hardware ups to accelerate Mac performance ft fete 
readers m on doit yourself tips foal can save them over 
25% on upgrade costs mm $3150 

FWBI A Fragment of Your Imagination by 

Joe Zobkiw Here's some practical help tor 
creating code resources and code fragments tor toe 
Macintosh and Power Macintosh. Rattier than simply 


For complete product Info see the MacTech Web" site at http://www.mactech.com. 
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gathering and indexing chunks of this vital code, the 
author provides thorough explanations to teach you more 
about h m the Macintosh system functions as a whole 
He also provides hard to find information about 
techniques used to structure and build fat. sale tat. and 
accelerated code resources tot use on both 880x0 and 
Power Macintosh Alt code is reusable and is provided 
on the disc, along with Mehowerks Code Warrior Lite 
Book/CD ROM. 5?8 pages M $35.96 

Mac Programming for Dummies' by Dan Parks 

Sydow takes the intimidation and work out of writing Mac 

programs. 4W& $17.95 

Programming for System 7 by Gary tittle and Tim 
Swihari, is a hands-on guide to creating applications tor 
System 7. It describes the new features and functions of 
[he operating system m detail Topics covered include file 
operations, cooperative multitasking, Balloon Help, Apple 
events, and bra File Manager Numerous working C code 
examples show programmers hnw to lake advantage of 
each of these features and use them in developing their 
applications. 384 pages mm $24.25 

Guido to Macintosh System 7.5 by Don Crabb 
Written by an indirstry expert. Ibis is the first thorough 
book on the new and improved Macintosh operating 
system, Readers will learn all the highbphls of the new 
System, including how to wofIc gfriclenUy with 
applications Intuitive task oriented approach teaches 
topics the way users think, not the way the machine 
thinks. Covers all the new features ot System 7.5. 
including PoweiTaik PC Exchange. and MacTCP Written 
by a wut Id-renowned Mac expert mm $22.50 

How To Write Macintosh Software by Scott 
Knaster is a great source lor understanding Macintosh 
programming techniques. Drawing Irom his years ol 
experience working with programmers, Scott explains the 
mysteries and myths ot Macintosh programming with wit 
and humor the third edition, fully rcvrsed and updated, 
covers System 7 and 32-bit developments, and explores 
such topics as how and where things are stored in 
memory, what things m memory can be moved around 
and when they may be moved, huw to debug your 
applications with MacsBug, how la examine your 
programs code to learn precisely what's going on when it 
runs 448 pgs (M $26 05 


Danny Goodman's Macintosh 1 * Handbook 
Featuring System 7 by Danny Gnnrimai! wilh Ridwd 
Saul Wurman iliis user friendly design includes a unique 
four color design and exploded diagrams, ft includes over 
100 spreads break down and clarity Mac problems and 
includes insider's bps mm $26 95 


Real World Apple Guide, For The 

Mac is the much anlicrpated help and 
navigational aid component ot the new Apple System 75 
OS The book is a practical introduction to Apple Guide 
for programmers It explains the design and function ot 
Apple Guide, how to design your own guides using Apple 
Script Comes with a disk of sample Apple Guides for 
AppteGutde^iipliaiiiap^jlicatiofis m% $35 95. 


Danny Goodman's Apple Guide Starter 

Kit by Damy Goodman and Jeremy Joan itowns twu 
highly respected experts otter a different approach fur 
creating your own Apple Guide databases. With 
Danny's Guide Startet program you can make guides 
quickly and easily, wdtrout having to loam a scripting 
language, write coded fifes, or use several different files 
and programs to produce your database (which is what 


you'd have to do without the program} Ihe authors 
provide advice and lips on how to design a good Guide, 
from planning and creation through testing revising, 
and indexing Book/drsk. 320 pages M $01.46 

HyperTalk* 2.2: Hie Rook Second Edition by Dan 
Winkler. Scott Kanins, aid Jeanne DeVoto is the most 
complete, authoritative source on Hyper talk 2,2 
programming and troubleshooting It covers each 
language element ol HyperTalk 22 (including the odd 
quirk or bug} mm $31.50 

The Complete HyperCard" 2.2 Handbook 
Fourth Edition by Danny Goodman is the bigqest- 
setting Mac book newly revised and updated tot version 
22 It shows how In buiW working applications using lira 
latest version of HyperCard and covers text, painting 
tools, extension commands (XCMQs}, scripting in 
HyperTalk, and more. mm $3150 

Dan Shafer Presents the Power of Prograph 

CPX js a hands-on, project-centered approach to 
learning the most revolutionary object oriented 
programming language on Ihe planet The language Kurt 
Schmucfcer likes best Hra language that programmers 
actually report having Tun" programming This 550-page 
book takes you step by step through three interrelated 
projects ot increasing complexity Along ftra way you’ll 
learn the underlying Prograph language, I*jw lu use the 
power ot lists, and the important aspects ol the CPX 
classes and object editors Includes disk with aft code in 
the book, mm $44 95 


pnm Visual Programming With Prograph 
UiJjM CPI by Scott B Stemman and Kevin G 
Carver This is the fust book on Prograph CPX available 
through Ihe book hade H covers Ihe only commercially 
supported visual programming language at a time when 
many programmers and managers, laced wtlti continuing 
productivity problems, are searching idr better programming 
euvirDmfirUs- Prograph CPX is much more than such GUI 
enhanced traditional languages as Visual Basic 11 literally 
allows you to draw your program flow using icons and 
create a complete application wilfruui writing a lino nf code. 
This book is an introdudion to the language and a Quids lor 
advanced users, tor both Macintosh and Windows-based 
machines. Prograph is a fully pictorial. general-pur pose, 
object-oriented language that speeds (fevfiloprowil with an 
integrated environment tor design, coding, test mg and 
debugging, wilh its 00 framework tor sophisticated GUI 
development, with its support tor calls from C. Cm, Pascal, 
and oilier routines: with its DAI, ORACLE. Sybase, AS/400 
dienl/server DB support, and many other powerful features 
Visual Programming With Prograph CPX leaches this new 
language and environment, filtering a careful pedagogic 
trealmerrt lull of useful examples and summaries of needed 
concepts mm $30.60 


Graphic Gems V Edited by Alan w Pasth is (he newest 
volume m the Graphic Gems Series. t( is intended to 
provide tte graphics aMranunitywift a setoff 
tor implementing new ideas and techniques, and to offer 
working solubons to real programming problems These 
tools are written by a wide variety of graphics programmers 
irom industry, academia, and research The books in this 
senes have become essential. bme-savrog toots tor many 
programmers It is the latest collection of graphics tips m 
The Graphic Gems Senes written by the leading 
programmers in the held It contains about 50 new gems 
displaying the most recent and innovative techniques in 
graphics programming. Also included is new gems in 
ellipses, splines. Bezier curves, and ray tracing Includes a 
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disk which contains source code Irom aU Five volumes and 
is available in both IBM and Macintosh versions 
CONTENTS: Algebra and Arithmetic Computational 
Geometry Modeling and transformation Curves and 
Surfaces Bay Tracing and Radiusily Halftoning and Image 
Processing Utilities mm $44.95 

Danny Goodman's AppleScript Handbook 

Second Edition by tony Goodman is a self-contained kit 
shows the reader trow to customize and extend the 
capabilities ol any Macintosh computer no programming 
experience needed' this enhanced and expanded edition 
of The Complete AppleScript Handbook focuses nn putting 
AppleScript to work In all sorts ot practical situations, to 
addition, Danny Goodman's AppleScript Handbook. 
Second Edition shows you how to apply the same 
principles to other popular scripting systems, such as 
UserUnd Frontier and QuicKeys Shows readers how to 
use scripts to enhance the Macintosh environment 
automate many processes, link data between applications, 
and much more This book provides a wealth nt all-new 
examples showing trow to integrate AppleScript with Ihe 
Finder, spreadsheets, desktop publishing programs, 
graphics applications, databases, telecommunications 
programs, utilities, and HyperCard The accompanying 3 
1/2* disk is jam packed with over $100 worth ot software, 
including AppleScript 11, valuable utilities, and powerful, 
ieady-to-usescripts mm $35.00 

The Complete AppleScript Handbook by 

Danny Goodman is a sett contained Ml to customizing 
and enhancing the Macintosh environment The disk 
contains AppleScript 1 I Runtime, Chang Labs 
TabtcServer, and useful, ready to-run scripts It also 
shows ft* Mac user now to automate many processes 
no pronr^Tifmrm e^tpenenoe raa^essary mm $31.50 

The Tao of AppleScript: BMUG s Guide to 
Macintosh Scripting, Second Edition by Derrick 
Schneider & Hans Hansen. this updated bestseller is a 
complete, natural introdutfton to AppleScript programming 
essentials Readers foam how to customize applications, 
automate tedious tasks, and create programs without 
having to use a complex programming language 2 disks 
cuiilai ii AppleScript, QuickTime, Sluftll Lite, RcsMnvci, and 
other helpful utilities Progressive structure meets the 
needs of any Mac user, regardless ot experience 
Professional instructions are mixed with practical examples 
lor my learning mm $26.95 

Wireless For The Newton Software 
Development for Mobile Communications by 

Julie McKcchan and Neil Rhodes is a hook Ural picks up 
where Programming for Ihe Newton fell oil, teaching the 
reader how to develop Newton" software on the 
Macintosh The enclosed Happy disk provides a sample 
application, as well as a fully functional demonstration 
version ot Newton toolkit" (NIK*), Apple Computers 
complete development environment (or the Newton* 
Gives frauds on Newton environment training with sample 
code creased specifically tor the Newton" The auttwrs are 
external faculty at Apple Developer University leaching 
classes on programming tor the Newt or 4 Programming 
experience is assumed, although not in any particular 
language Enclosed is a floppy disk which contains 
source code for a Newton application, as well as 
demonstration NTK" mm $31.45 


NEW! 


Bask For The Newton Programming tor 
[to Newton Using NS Baste by John Schettino 
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& Liz O'Hara thus book shows owners d New*on devices 
how to become Newton programmers using BASIC The 
authors use a sbaigM-torwato ^programming by example* 
approach, which should Have you writing your own 
Newton programs right away II Includes one 35* disk 
containing Demonstration NS BASIC and over fitly 
example programs horn the book il is Midti-platlorm in 
that leaches programming tor the Newton using a 
Macintosh, a Windows-based PC. or on the Newton 
device toll mm $32.35 


Programming for the Newton Software 
Development with NewtonScript by Julie 
Mr.Kecfian and Neil Rhodes Foreword by Walter R 
Smith Programming lor the Newton Software 
Development with NewtonScripl is an indispensable tool 
for Newton programmers. Readers wilt learn how to 
develop sollwara lor the Newton on the Macintosh from 
people lhal davsiupad the course on programming Ihc 
Newton tor Apple Computer The enclosed 3.5’ disk 
contains a sample Newton application from the books, as 
well as demonstration version of Newton Toolkit (NTK), 
Apple Computers complete devetopmeril environment for 
the Newtons A PuWktfian at AP Prolessmryl May 1994, 
Paperback. 393pp mm $26.95 

Metrowerks CodeWarrior Programming by Dan 

Parts Sytkw Includes CodeWarrior Lite. and Tull Coverage 
of Power Plant 111 the best information on Metrowerks 
CodcWamor 6. giving full coverage lo the Goto trillion 
Eiren it you don’t already own CodcWarnor 6. you'll stilt be 
able to work with the examples in this book, using the 
COifcWsrnnr 6 Uc CD Ural cumtis with il mm $35.95 


C++ Programming With CodeWarrior 

Beginning OOP lor the Macintosh and Power 
Macintosh by Jan L Harrington hom AP Professional, 
This book shows programming novices object-oriented 
programming techniques for the Macintosh. Power 
Macintosh, and Mac OS compatibles, using C++ as the 
example language and Metrowerks and CndeWarrior as 
the example compiler The enclosed CD-ROM contains 
example code from the book and a lull-fund ion 
Melrowfifks CodeWainot compiler tor running these 
examples. M $32.35 


Optimizing PowerPC Code: Programming 
the PowerPC In Assembly Language - To lake 

fuff advantage of the potential of It* PowerPC, Developers 
need to master the Assembly Language techniques This 
book shows how to use the Assembly Language in 
PowerPC Programs In produce faster more robust 
software |M $35.96 


Power Macintosh Programming Starter Kit 

by Tom Thompson this is the first totoual/rfllerericc 
tor programmers who warn lo enter the new world at the 
PowerPC chips Users fmd all the details on the new 
microprocessors. the new RISC architecture. and how lo 
write native code and emulation operations to create 
their own software for the Macintosh PowerPC CD- 
ROM includes a unique compiler tor writing code 
easily The alhn-orw hook that gets programmers the 
information and tools they need Programming 
examples reinforce explanations of code and 
programming tools $39-99 $35.10 


PowerBook The Digital Nomad's Guide 

by Andrew Gore and Milch Hatdiitc fcMOQ $21,60 

The ResEdft All Night Diner by David Ciskowski 
An idea-filled menu and Introduction to the |oys of 


customizing software - and adding personally to Ihe Mac 
with ResEdil 1 Shows readers how to customize default 
icons, the text at menus and dialog boxes, cursors, 
pointers, and more Provide spedlrc recipes tor doing 
creative things with Hestdr! plus how to avert problems 
Disk features ResFdit program, plus lots of sample 
resources mm $22 45 

ResEdit" Complete, Second Edition oy Peter 
Alley and Carolyn Strange With FtesFdit Macintosh 
programmers can customize evE*y aspect of their interlace 
form creating screen backgrounds arid icons to 
customizing menus and dialog boxes, 608 pages 
Buok/disk package M $31.45 

Sad Macs, Bombs, Disasters and What to 
Do About Them by led Undau comes to the rescue 
with your Macintosh problems From haclious lords to the 
ominous Sad Macintosh icon, this emergency handbook 
covers the whole range of Macintosh problems 
symptoms, causes, and what you can da to solve them 
640 Pages, mm $22,45 

Macintosh * Crash Course by Glenn Brawn shows 
Macintosh power users what to do when things go wrong 
with Itwir system Macintosh Crash Course shows readers 
how to overcome Macintosh system crashes, system lock¬ 
ups, and various, frustrating and cryptic error messages 
they regularly encounter It includes a CD-ROM with 
shareware and freeware lo help the user diagnose and 
repair system failures, Includes up-to date coverage 
through Macintosh System 7 5. Managing memory, 
Hardware diagnostics, Hie recovery. ftjwerBonk problems 
PowerPC problems, nelwuik utilities, hard drive repaii 
utilities. SCSI problems, conflicts and solutions and File 
synchronization and irtilihcs fcflOfe $26.95 

Multimedia Authoring: Building and 
Developing Documents by Scusi Fistirr addresses 
the concerns that lace anyone trying to create multimedia 
documents tt otteis speeilic advice on when to use 
different kinds of information architecture, discusses the 
humarHadors concepts thal determine how readers use 
and retain information, and tfwm applies Ihcsc findings to 
multimedia documents, covering the high-level issues 
concerning planners and authors ot multimedia 
documents as well as those involved in evaluating or 
purchasing multimedia platforms. Includes one 35“ higlr- 
dnnsity disk M £31.45 

Multimedia Starter Kit fur Macintosh by 

Michael D Mune. This hands on book offers lire Idlest and 
gmatesi in multimedia tor the Mac 1 taifcrs learn how to 
design Iheir own multimedia projects step by step, then iry 
it themselves with the damns, graphics, clips, and sample 
projects on the CD-ROM! CD-ROM eonlains QuickTime, 
sound and graphics clips and utilities, sample projects, and 
more. How to choose and use a variety of Macintosh 
multimedia toots and presentation environments. includes 
demos of Adobe Illustrator. Premiere. Hetzer Software 
programs, arid more $ 3000 $27.00 

QuickTime Starter Kit tor Macintosh by Robert 
A LFtitefi A Judith Slam This is the ultimate package tor 
getting productive and having tun with Macintosh movie- 
making Easy steps and valuable software Irtp readers 
play. make, and edit QuickTime movies CD-ROM 
includes QuickTime tools, movie clips, shareware, and 
demos ot Premiere and other programs Written by 
members of the respected Berkeley Macintosh User 
Group, Tips on the best ways to bring live-action video to 


Mac mu It in ied i;i mm (48.56 

Adobe Premiere for Macintosh: Classroom 
in a Book, Second Edition -jy Adobe Press This 
is the updated edition of the official Adobe framing 
workbook 1 Covering all the essential features at this 
video editing software. tors boottCD-ROM set features 
twenty tutorial lessons lo guide teachers and students 
through the magic of Macintosh movie making CD-ROM 
includes QuickTime movies, electronic images, and 
frames needed for the workshop lessons m the book 
Detailed yef easy to-tollow steps to Dealing multimedia 
presentations, animation, and videos Contains the latest 
information on titters, audio, superimposed clips, 
advanced editing, and more WCF9& $44.95 

3-D Starter Kit for Macintosh by Sean Wagslaff 
The compile reference to 3-D graphics on the Macintosh 
ideal for beginning to intermediate product designers, 
illustrators, graphic designers, multimedia developers, 
animators, and video producers, as well as architect arid 
engineers! Covers more than 50 major Macintosh 3-D 
imaging softwaie packages - the most comprehensive 
book available Lots of idea-packed examples that 
illustrate how 3-D products work individually and 
togelher CD-ROM includes sample models, image 
galleries, backgrounds, and textures, plus 3 D software 
tryoul versions $4&4Q $36 JO 

Net Chat' by Michael Wolff $ Go There are an 
estimated 35 million people online and most ot them spend 
rime chatting on the Net Net Chal is the first 
comprehensrve. discriminating guide devoted to tire vast 
world of online interpersonal communications Fuihiwing 
ihc successful formal ol ihc ever popular Net Guide, Nef 
Chat is designed lur easy access, featuring ari attractive 
layout, teformalive illustrations, and thousands of choices 
It is encyclopedic m scope covers ‘chaf groups on the 
Internet, aft the major commercial services (including 
CompuServe Prodigy, and America Online), and hundreds 
nf bulletin boards. Il features a map of salons and meeting 
places m Cyberspace, where people stop to chat about 
politics, lifestyle. music, dating, sex, tanlasy, health. My, 
and just about everything imaginable! The entries include 
one- and two page spreads lhai describe the fcaimrt lopic. 
and provide easy access instruct!ms, complete listings, 
and visual images tram the Nel For use with all computer 
platforms PCs. Macs, workstations mm $17.00 

MORE Internet Far Dummies" by John Levine A 
Margaret Levine Young The expanded guide lull ol great 
Internet bps for all those users who want to know wtiere to 
go and whal 10 du ow e i nnnected. H 99 b $17.95 

The Instant Internet Guide by Brant Hcsiop and 
David Angel! An Internet |ump-sfett - how to access, use 
and navigate global networks, the Inslanl Internet Guide 
equips ffirters with the foots needed to travel fhe etedrtmic 
world the book highlights the most important sources ol 
in ten wi news and informal ion and explains how lo arm s 
information on remote systems II milium how io use 
esseolul Internal utilities and programs and includes a 
pumer on UNIX tor the fniemet 224 pages mm $13.45 

The Internet y Paul Hoffman gives the straight scoop 
on the Net wilh the elegant, entertaining 4-color 
companion to the PBS special "The Internet Show “ Coiw 
photos and illusbattons explain Interne! key features, its 
history, and trivia Covers Ww basics and also a multitude 
nf Internet Information Services and extensive lisis of 
Internet sites mm $22,50 

The Internet, Deluxe Edition by Pam Hoffman All 
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of the brilliance of The Internet plus the hot NetManage 
Internet Chameleon tfifiwami this bundled Deluxe Edition 
includes everything you need to suit the Net 1 Fully 
automated, feftManagti fus put together 3 desks filled with 
Internet tools, semce providers, appi cat ions and more - 
an unbelievable value* $3499 $3150 

The Internet For Macs For Durnmies^by 

Charles Seiler Now novice Mac users have an Interne! 
guide written especially lor mm - in the easy for 
Dummks™ style they love *44^90 $17*95 

The Internet For Dummies" 2nd Edition by 

John Levine and Carol Bamudi. Surf Ihe net with ease 
using the up liHfie rnhiule new edition ol the It 
bestselling Internol rrtlHmneif - now with Iriendly help on 
connedirig tn the Ifiltimnt 4M $17.99 

The Internet For Dummies" Quick 
Reference by John Levine, this tact'filled quick 
reference provides plain English explanations ot Internet 
terms and basins Cross-referenced to "The Inlcrncl For 
Dummies" M $8.05 


The Internet For Macs For Dummies 4 
Starter Kit by Charles Salter Access and navigate the 
Net like a pro the fun and easy way wiih ihis afhmdustvc 
Starter Kii for Mac user s Kil includes a special edition of 
the bestselling Ihe tiller net Foi Macs Fot Dummies^ plus 
fwn disks tealuimy I he Pipeline and TCP/Cwmecl ir 
Extended sollwaie with E-Mail. UscNet News Header. 
F1F. TetneL Coptic/, and more' IM 525.99 

Internet Power Tools by John Boss is designed tor 
PC users, Interne! Power Toots is a complete 
book/disk package Hui allows access to the world* largest 
neiwtifk - Hie internet - with the same case as one uses 
Windows The detailed msiructiofts allow readers to find Iheir 
way around the Internet test and mvnrs e nad Ide transfers, 
remote logon, on tine directories, and more The 
accompanying disk Is packed with powerful utilities, 
including Cello, PC fcuttota, and Panda - easy-to use 
graphical usm infos Cm (GUI) Ifial obviate Ihe need lor the 
obscure Unix line cuniraids that everyone else must team 
If aJsn provides assess to even more software via Random 
House's Internet FTP site arid shews how to conned to Ihe 
Internet m a network connection or dial-in M $36.00 


The 1994 Internet White Pages by Seth Godin h 
James S McBride is the one and only complete alphabetical 
ilirectory ol people on the Internet mm $26.95 

Internet SECRETS try John Lev me & Carol Baroudi 
gives the mnsl from the Net with this performance 
oriented book - lor Windows. UNIX, DOS. and Mac 
Interne! users wfiu know how to get connected but want lo 
nphmLffi Itmifconnections W93 $35.99 


nfffffl Web Head; The Mac Guide to the 
UAiU World Wide Web by Mary Jane Mara 
Published by PeachPil Press This is a beginning to 
intermediate book that shows you how to gel the most 
from the Web. using plain talk thal beginners wilt 
understand, and online veterans will appreciate Web 
Head also includes m-depth tours of the three leading 
Web browsers tor the Macintosh Netscape. MacWeb and 
MacMosaic. and explains the basics behind all Web 
browsers so you will be ready even when me next hot 
Web browser hits 1t» scene I! will also tell you how to get 
connected to the Web. Itmkng your way across webspace, 
flm-tunlng your Mac lor top Web performance, and how 
to turn your Mac into a multimedia Weft browser there is 
also instruction on how to build your own home page, 
posting pages on Ihe Wfeb and avoiding common HTML 


mistakes mM $2245 


mm The Underground Guide to Tele- 

Mi*" commuting by Woody Leonhard, Addison 
Wesley Theft s no place like home bpecwtly when your 
boss, your lud. and the neighbor* dog m all barking lor 
your attention simultaneously Working away from i 
corporate office presents great (often unexpected) 
challenges and offers even greater rewards Woody 
Leonhard takes on Ihe toughest aspects of letecomcmting 
and gives you the straight scoop on how lo make it work 
tor you Whether youte a telecommuter, a telecommuter's 
boss, or just curious, the Underground Guide to 
Telecommuting will give you the tools and information 
you need to turn electricity and a phone line into major 
productivity mm $22 45, 


The Elements of E-Mail Style by Brent Hestop 
and David Angeli Learn the rules of the road in the e-mail 
age Concise, easy-lo-use format explaining essential e- 
mall guidelines and rules It covers style, tone, 
typography, formatting, politics and etiquette. It also 
millings basic rules of composition within the special 
context of writing e-mail and includes samples and 
templates for writing specific types ul e-mail 
correspondence 2Qfi pages I444fe $13 45 


E-Mail Essentials by Ed Trttel & Margaret Robbins is 
a hands on guide to Ihe basics of e-mail, the ubiquitous 
networks rommunicaJian system The book is suitable lor 
both the casual e-maile and the networking professional, 
as a covers everything from toe installation of c mail to the 
maintenance and management at c mail hubs and 
message servers. The books explains the fundamental 
concepts and lechnotogies of electronic mail, featuring 
chapters on Lotus applications and CompuServe, as well 
as information on upgrading, automation, mess.ige-based 
applications, and user baffling F mart Essentials is a step- 
by-step. jargon-bee guide that will enable the e-maii user 
to ge! the most out ol the communication potentials of 
networking 250 pp mm $22 45 


fflWI The Computer Privacy Handbook is 

a practical guide to e-mail encryption data 
protection, and PGP privacy soltware With millions ot e- 
mail messages and on-line discussions exchanged daily 
on the Internet, electronic security has become a key 
concern The Computer Privacy Handbook explains 
practical steps individuals can take to safeguard their 
electronic security. It also gives a vivid description oi 
how the "Surveillance Age" threatens each person s 
personal security, a nontechnical introduction into date 


encryptiun, and the U S Government's Clipper Chip 
surveillance proposal It also provides an overview at 
PGP, (Prelly Good Privacy), the world standard for e-mail 
privacy, mm $22 45. 


America Online For Dummies ' by John Kauictd 
"Driver's Education" lor Bus wildly popular on-line service - 
covering everything tram Ihe nan menu to toe mad groups 
tor Wi ndows. DOS, and Mac platforms Includes a coupon tor 
tree usage time on AOt tortirel-bme users M $17.95 


CompuServe For Dummies" by Wallace Wang 
Find out how to shop, play games, [ton torums, get die 
latest news, do research, and more on this popular on¬ 
line service %tm $17,95 


eWorld: The Official Guide for Macintosh 
Users by Cary Lu & John Milligan Discover toe next 
generation of on linn services - Apples eWorld Certain to 
be a bestseller, this authorized guide to contains the 
exclusive Apple strflwsire needed lo conned to eWorld tl 
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also provides a mad map eWorld and all of its features, 
aid 5 toe test and best book on this exoimg new service 
Covers every aspect ot eWorld, the next generation of 
online services Everything users need to get connected 
and get If* most out oi eWorld The only official Apple 
book and software tor accessing eWorld mm $26 95 


NEW! 


PowerPC System Architecture try 

MtodShare This book describes me hardware 


architecture of PowerPC systems, providing a dear, 
concise explanation of ihe PowerPC specification, the 
template upon which aft PowerPC processors are 
designed The author provides a complete description ol 
the specification tor both ihe 32- and 64-bit 
implementations 656 pages I34Q& $3146 


B PCI System Architecture, Third 
Edition by MinUShare. Describing revision 


2 1 of the Peripheral Component Interconnect (PCI) bus 
specification, this book explores PCt's relationship lo Ihe 
ftsl ol the system ft includes an in-depth treatment of 
PC! to PCI bridges, the PCI BIOS, the 66MHr PCI bus. 
and more 592 pages mm $3146 


pmjl Cyberpunk Handbook, The Real 
Cyberpunk Fakebook by St. Jude, 
fl LLStrius. and Bart Nagel Published by Random House. 
This book Nts bow to fell if ya/or someone you knnw is 
a Cyberpunk mm S6.95 


THE APPLE 1JBKAKY 


mm Advanced Color Imaging On the Mac 

QS explains how you ran augment the color 
support supplied with Guicfcrtraw. and GuickdrawCX 
using hit Palette manager to provide toe best set ol colors 
on displays wiUi limited color capabilities, soliciting tire 
color choices from users wiih Ihe color Picker Manager/ 
Using rhe Color Sync manager to match colors between 
screens and input and output devices such as scanners 
and printers/ learning how the color Manager assists 
Color QuickDraw in mapping m applications color 
requests to the actual enters available mm $33.25. 

mm 3D Graphics Programming Using 
mMm QuickDraw 3D tjy Apple Computer, Inc 
Now you can incorporate spectacular 3D graphics into 
your applications This bonk/CD-ROM package explores 
QuickDraw 30. a graphics extension to Hie Mac QS tor 
Power Macintoshes The CD contains ihe complete 
QuickDraw 3D system itself and a complete database ol 
Ihe QuickDraw 3D API, allowing you inslant access to the 
hundreds of graphics calls via a fast viewing engine. 
Book/CD ROM, 640 pages m $35 96 


NEW 


Apple Guide Complete by Apple 
Computer. Inc For those who wan! toe toll 


power of Apple's complete toolset, tots book and CD 
RDM package from Apple provides everything you need to 
produce guide files successfully, including Guide Maker, 
Hie soltware you use to build and test guide files You'll 
learn about Ihe complete cycle ot designing as well as 
advanced topics such as scripting and ending guide hies. 
Bnnk/CQ-RQM, 544 pages mm 535 96 


inside AppleTalk by Gursharan 5. Stdliu. Richard F 
Andrews and Alan B Oppcnhcimer Apple Computer tnt 
659 luges $3496 $3145 


AppleScript Finder Guide, English Dated by Apple 
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Computer, Inc. mm 117.95, 

AppleScript Language Guide, by Apple 
Computer, inc. mm $ 26 . 95 . 

AppleScript Scripting Additions Guide, ay 

Apple Computer. Inc $17.05, 

HyperCard Stack Design Guidelines by Apple 
Computer, me is arc essential book tor everyone who 
creates Apple HyperCard slacks, from beginners lo 
commercial developers. It covers the basic principles of 
design that, when Incorporated, make HyperCard stacks 
effective and usable. Topics include guidelines, 
navigation, graphic design and screen Illustration, text in 
stacks, music and sound, a sample stack development 
scenario, collaborative development, and the Stack 
Design Checklist 240 pages, mm $19.95 

Macintosh Programmer's Toolbox Assistant 

CD-ROM Instant electronic access to Inside Macintosh 
essentials. Now Macintosh programmers can get quick 
access lu over 4,000 Toolbox calls lhal are al the heart ol 
Macintosh system software. The definitions of these data 
structures, resources, constants, and functions are 
documented in the Inside Macintosh series and are 
essential information for anyone developing Macintosh 
software Macintosh Programmer* Toolbox Assistant is a 
CD-ROM that harnesses the power nt one of the besl 
search and viewing engines In the Industry it allows 
programmers to access the Toolbox alts quickly 1mm their 
development environment With hypertext links allowing 
programmers to view related topics easily Macintosh 
Programmer's Toolbox Assistant IS tlie ultimate electronic 
relerancc toot for Macintosh programmers $99.95 

Inside Macintosh' : CD-ROM by Apple Computer. 
Inc Inside Macintosh is the essential reference for 
programmers, designers, and engineers tor creating 
applications foi the Macintosh family of computers Inside 
Macintosh CD-ROM colled 5 more then 75 volumes In 
electronic form, including: QuickDraw* GX Library, 
Macintosh Human Interlace Guidelines, PowerPC System 
Software Macintosh Toolbox Essentials and More 
Macintosh Toolbox, QuickTime and QuickTime 
Components Now programmers will be able lo across over 
TB ,000 pages nl the information ihey need direclly Irom their 
computers Hypertext linking and extensive cross referencing 
across volumes allows programmers to search and explore 
this library in ways that are unique to tlie electronic medium 
Every Macintosh programmer will regard Inside Macintosh 
CD-ROM as Iheir most important resource $99.95 

Inside Macintosh": Overview 1 y Apple Computer, 
Inc is ihe first book Thai people who are unfamiliar with 
Macintosh programming should read It gi m m overview 
u( Macintosh programming fundameulafs and a road map 
to the Hew Inside Macintosh library Inside Macintosh 
Overview also covers various programming loots and 
languages, compatibility guide!roes and an overview of 
considerations for worldwide development 175 pages. 
mm $20.65 

Inside Macintosh : Files by Apple Computer. Inc, 
describes the parts ol Ihe operating system that allow you 
to manage hies ft shows how yuui application can handle 
the commands typically found in a Fite menu It also 
provides a reference to Ihe Fite and Alias Managers, the 
Disk IniilaH/ahott and Standard File Packages SID pgs. 
mm $ 26.95 

Inside Macintosh 14 : Operating System 


Utilities by Apple Computer, Inc describes parts ol the 
Macintosh Operating System that allow you to manage 
various low-level aspects ol the operating system Everyone 
who programs the Macintosh should read this book! It will 
show you in detail how lo gel information about the 
operating system, manage operating system quaies. handle 
dates and times, control the settings of foe parartKtet RAM, 
manipulate ihe ir^i dispatch table, and receive and respond 
to few-ferel system errors mm $23.45 

Inside Macintosh*: Processes by Apple 

Computer, Inc. describes The parts of the Macintosh 
operating system that allow you to control the execution 
ol processes and interrupt tasks tt shows In detail how 
you can use the Process Manager to get Information 
about processes loaded in memory It is also a reference 
tor the Vertical Retrace, Time. Notification. Deterred Task, 
and Shutdown Managers 208 pages mm $20.65 

Inside Macintosh : Memory by Apple Computer. 
Inc. describes the parts of the Macintosh operating 
system that allow you to manage memory It provides 
detailed strategies lor allocating and releasing memory, 
avoiding low-memory situations, reference to Ihe Memory 
Manager, the Virtual Memory Manager, and memory 
related utilities 296 pages mm $22.45 

Inside Macintosh"; AOCE Application 
Interfaces by Apple Computer. Inc shows how your 
application can fake advantage ul the system software 
Mures provided by PowcrTalk system software and the 
PowerShare collaboration servers Nearly every Macintosh 
application program can tend it from Ihe addition of some 
of these features. This book shows how you can add 
electronic mail capabilities to your application, write a 
messaging application or ageni. store information to and 
retrieve information irom PowerShare and other AOCE 
catalogs, add catalog browsing and find-in-calakg 
capabilities to your application, write templates (hat extend 
the Finder* ability to display information in PowcrShare 
and other AOCE catalogs add digital signatures to files or 
to any portion of a document and establish an 
aullienlleafedmessaging connection $ 4 045 $ 36.40 

Inside Macintosh": AOCE Service Access 
Modules by Apple Computer, Inc describes howto write 
d software modulo that gives users and Power Talk-enabled 
applications access to a new or existing mill and 
messaging service or catalog service This hook shows 
how to write a catalog service access module (C3AM), a 
messaging service access module (MSAM), and AOCE 
templates lhal allow a user to sol up a CSAM 01 MSAM and 
add addresses to mail and messages mm $24,25 

Inside Macintosh-: Devices try Apple Computer, 
toe, deserthes how to write software tbal interacts with 
built-in and peripheral hardware devices Wtlh this book, 
you'll learn how lo write and install your own device 
drivers desk accessaries, arid Chooser extensions, 
communicate with device drivers using the Device 
Manager, arms expansion cants using Ifxs Sim Manager 
control SCSI devices using SCSI Manager 4 3 or the 
original SCSI Manager, communicate directly with Apple 
Desktop Bus devices, interact with rhe Power Manager in 
battery po were d Macintosh computers, and communicate 
with serial devices using foe Serial Driver $26 95 

Inside Macintosh*: Macintosh Toolbox 
Essentials uy Apple Computer Inc covers the heart ol 
the Macintosh The toolbox enables programmers to 
create applications consistent wiih the Macintosh look 
and leer. This book describes Toolbox routines and 
shows how to implement essential user Interlace 


elements, such as menus, windows, scroll bars, icons and 
dialog boxes 680 pages mm $31.45 

Inside Macintosh* : More Macintosh Toolbox 

by Apple Computer, Inc. covers other Macintosh features 
such as how to support copy and paste, provide Balloon 
Help, play and record sound and create cortrot panels are 
covered in this volume The managers discussed include 
Help, list. Resource. Scrap and Sound mm $31.45 

Inside Macintosh*: Networking by Apple 

Computer. Inc describes how to write software that uses 
AppleTalk networking protocols, M describes the 
components and organization of AppleTalk and how to 
select an AppleTalk protocol It provides the complete 
application interfaces to all AppleTalk protocols, including 
ATP (AppleTalk Transaction Protocol), DDF (Datagram 
Delivery Protocol), and ADSP [AppleTalk Data Stream 
Protocol), among others {tt $25.95 

Inside Macintosh": Interapplication Com¬ 
munication by Apple Computer, Inc shows how 
applications can work together. How your application can 
share data, request information or services, allow ihe user 
to automate tasks, communicate with remote databases 

mm $31.45 

Inside Macintosh": PowerPC Numerics by 

Apple Computer, Inc. describes lie floating-point numerics 
environment provided with the first retease ot PowerPC 
processor based Macintosh computers. The numerics 
envtroomenl conforms to the IEEE standard 754 lor binary 
ridating-puml arithmetic This book provides a description 
ol that standard and grows how RISC Numerics compiles 
with h. This book also shows programmers how to create 
floating-point values and how to perform operations on 
floating point values in tugh-tevel languages such as C and 
in PowerPC assembly language mm $25.00 

Inside Macintosh": PowerPC System 
Software by Apple Computer Inc. describes the new 
process execution environment and system software 
services provided with ihe first version ol ihe system 
software for Macintosh on PowerPC computers If 
contains information you need to know lo write 
applications and other software tbal can run on the 
PowerPC, PowerPC System Software shows in detail how 
to make your software compatible with Iho new run lime 
environment provided on PowerPC-based Macintosh 
computers, II also provides a complete technical reference 
fur the Mixed Mode Manager, Ihe Code Fragment 
Manager, and die Exception Manager $22.45 

Inside Macintosh* 1 : Sound by Apple Computer, 
Inc describes the parts of the Macintosh system software 
(fiat allow you to manage sounds II contains Informal ion 
that you need to know to write applications and other 
software lhal ran record and play back sounds, compress 
and expand audio date, convert text to speech, and 
perform olhei similar operations mm $24 25 

Inside Macintosh : Text by Apple Computer. Inc 
describes how to perform text handling, Irom simple 
character display lu multi-language processing The Font, 
Scupi, Text Services, and Dictionary Managers are all 
covered, in addition to QuickDraw text, TextEdit, and 
rnicrnaticmal and Keytx^ard Resources I mm $35.95 

Inside Macintosh : Imaging by Apple Computer, 
Inc covers QuickDraw and Color QuickDraw The book 
includes general discussions nt drawing and working with 
color It describes the structures that hold Images and 
image information, and foe routines that manipulate them. 
It also covers foe Palette, Dolor, and Printing Managers, 
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and the Color Picker, Color Matching, and Picture 
Utilities M $24.25 

Inside Macintosh : QuickDraw GX Graphics 

by Apple Computer, Inc shows readas how to create aid 
manipulate the lundameniaf geometric slsapes of QuickDraw 
GX to generate a vast range of graphic entities It also 
demonstrates how to work with bitmaps and pictures, and 
5p«:nk^Quic4Ji,rwGX graphic shapes mm $24.25 

Inside Macintosh : QuickDraw “ GX Objects sy 

Apple Compute*. Inc. introduces QuickDraw GX and its 
abject structure, and shows programmers how to manipulate 
objects in alf types Ql progams mm $24,25 

Inside Macintosh 1 *; QuickDraw' GX 
Environment and Utilities A companion to 
QuickDraw' GX Objects, this book contains programming 
Information useful to any developer writing QuickDraw GX 
applications ft describes QuickDraw GX memory 
management, error handling, debugging, and 
mathematical functions, as well as conversion from 
QuickDraw rn QuickDraw GX mm $26 95 

Inside Macintosh : QuickDraw" GX Library 

by Apple Computer, Inc is the powerful new graphics 
architecture tor the Macintosh Far more than just a 
revision ot QuickDraw. QuickDraw GX is a unified 
approach to graphics and typography that gives 
programmers unprecedented flexibility and power in 
drawing and printing all kinds ul slopes, images, and text. 

Inside Macintosh*: QuickDraw" GX Printing 

This bonk is essential (dr any developer whoso QuickDraw' 
GX appJrabnri supports printing It shows how to support 
the new printing features ul QuickDraw GX, including 
desktop printers ami expandable printing dialog boxes. 
QuickDraw GX Ptinllng also straws Iraw to use printing- 
related objects to add custom panels to printing dialog 
boxes and to create custom page formats mm $24.25 

Inside Macintosh: QuickDraw GX Printing 
Extensions and Drivers Any developer whu wants 
to create extensions lo the application pntiling capabilities 
of QuickDraw' GX, or who needs to write a printing device 
driver that works wilt) QuickDraw GX needs this hook 
QuickDraw GX Priming extensions and Drivers describes 
how In create printing extensions and printer drivers, and 
provides a complete feterenen In the messages, functions, 
arid resources trial limy use mm $26 95 

Inside Macintosh*; QuickDraw" GX 
Programmer's Overview This book provides an 
introduction In QuickDraw" GX, providing an overview of 
the QuickDraw GX environment from a developer's 
perspective It Introduces Hre QuickDraw'" GX 
programming and rutimw environments, the rat at inn ship 
between QuickDraw GX and the rest of lira Macintosh'" 
systems software and the relationship between QuickDraw 
GX and Macintosh applications The key elements ot 
QuickDraw GX programming, data structures, object 
types, and functions used must frequently by QuickDraw 
GX dmioperi are also covered After a general 
introduction this book provides readers with a senes of 
practical examples demonstrating how lo approach 
programming with QuickDraw GX mm $22.45 

Inside Macintosh*; QuickDraw" GX 

Typography - This book is essential for any developer 
who uses QuickDraw' GX lo manipulate text IT shows 
how to use QuickDraw GX objects lo handle alf kinds of 
text - from plain, unstyled text to complex, mixed- 
direction and multi-language text with sophisticated 
stylistic and typographic variations QuickDraw GX 


Typography shows how to create and manipulate the three 
different types of text shapes supported by QuickDraw GX 
including text shapes glyph shapes, and layout shapes 

mm 526.95 

Inside Macintosh ": QuickTime by Apple Computer 
kit is tat anyone who warts to create appEcahcns that use 
QuickTime, me system software that allows the integration at 
video, animation, and sounds into applications This book 
describes ail ol the QuickTime Toolbox utilities In addition, I 
provides the information you need to compress and 
decompress images and image sequences mm 526 95 

Inside Macintosh": QuickTime Components 

by Apple Computer. Inc.coveis how to use and develop 
QuickTime components such as image compressors, movie 
controllers, sequence grabbers, and video dlgiluers. mm 

$ 31.45 

Inside Macintosh : X-Hef by Apple Computer, Inc is 
a fast access to all the information In Inside Macintosh 
Inside Macintosh X Ret, Provides programmers with a quick 
anti easy way to find the exact intnrmatinn they need m this 
drfmHMj suite of hooks, (alf 76 volumes) H is indexed by 
topic, volume, chapter, and accompanying page number 
mm 517,95 

Inside the Macintosh Communications 

Too I Box by Apple Computer Ifus book is tie definitive 
reference to the Macintosh Commumcaliofis Toolbox, an 
integral part of the System l Macintosh loulbox ttat enables 
developers to create communications applications or add 
communications features to other applications This book 
describes all ot the routines mat provide programmers with 
standard access to important communicaliom sendees anti 
m addition enables programmers to extend the reach of the 
Maanloshrnlonoii-AppleenvironrT^ib mm 522.45. 


FDITORN 



BBEd it 3.1 hum Bare Bones Software is nuw better than 
ever In addition to being Accelerated fur 
f ovrer Macintosh, this poweriuL intuitive text 
pditoi offers integrated supper! ti; iHfNK C 
1/ 9. Metrowerks CodeWamor 6. THINK 
Reference 2 0 and MPW TootServer. Version 31 adds even 
more capability, including "soft' wrapping ol text on screen 
and numerous refinements and improvements to ibe user 
interface BBEdit s many features include Integrated 
PopupFuncs* technology for speedy navigation of source 
code files (C. C++, Pascal, Rez, 68K Assembler, and 
Fortran), unique Find Differences' command (BREdit can 
find differences between projects and folders as well as 
fifes), support for Macintosh Drag and Drop lor editing and 
other common tasks, PowerTalk support for reading, 
sending anti composition of PowerTaik mail, scripting via 
any OSA compatible scripting language including 
AppleScript and Frontier 3.0, and test search and replace 
with optional "grep" matching and multi-fit# searching. 
RBCtiifs robust feature set and proven performance and 
reliability mate if the editor ot choice for professionals and 
hobbyists alike $99 


CMaster 2,Q try Jersey SaenbV; installs mto THINK C 5 
/ 6 / 7 and Symantec C++ for Ntapriush. and enhances the 
editor Use its 1 unction popup lu select a function and 
CMastef takes you right to tl. Otter features indude multiple 
clipboards and markers, a Function Prototype*, and a 
Gotek Menu which can late you back to previous editing 
contexts Almost all features timetable lo Itie keyboard, along 
over a hundred keyboard-oniy features like "Add New 
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Automatic Variable" Glossaries, AppteScr^ and TotfSava 
support Macros and External Tools you create loo 1 $129 95 

QUED/M 2J by Ntsus Software, is a programmer's ted 
editor which has defined toe industry standard tor speed and 
efficiency With integrated support for Symantec C/C++. 
Metrowerks CodeWamor 6. and MPW, QUED/M offers 
unnvafed usefulness tor the Macintosh develop© In addition 
to supporting all toe major development environments on the 
Macintosh, QUFD/M offers Owens of powerful editing 
features, including utiUmlted undo and redo, UNIX style 
GRFP arching, macro language?, scripting, text folding text 
sorting, fife comparison and merging, Toolbox lookup, fen 
nditable/appendablc clipboards, line numbering, markers, 
displaying texl as ASCII codes, vortical and horizontal screen 
spill!inq, plus much more $149 


DEVIiiJOPMfcJVr ENVIRONMENT* AND 
LANGUAGES 


;J3 CodeWarrior “ 7 CD hy Mefrowerks 
3 comes in two versions Bronze and Goto 
TM/t' These CDs contain the Code Warrior 6 
* *[y development environment including C++ C 
V EW S& and Pascal compilers, high-speed tinkers; 
native mode interactive debuggers, and a powerful new 
application framework called PowerPlant for rapid 
Maciniash cfevnfnpmcnl in C++ Bronze generates 680x0 
code Gold generates both 68M and PowerPC code. Ail 
versions am a 3 CD subscription over a t year period 
Bronze: $149. Gold: $399. Bronze comes with a 6* 
month MacTech subscription. Gold comes with a 
Hear subscription Both at no additional charge! 


SYMANTEC. 


Symantec C++ tor Macintosh is an object 
oriented development environment designed for 
professional Macintosh programmers Symantec C++ 
features powerful object-oriented development foots 
within a completely integrated environment The C++ 
compiler, incremental tinker, THINK Glass Library, code 
ediloi with coloring, integrated browser, debugger with 
stack crawl, and automatic project management give 
Symantec C++ Iasi turnaround limes. This product 
compiles fur both PowerPC and 6BK machines Symantec 
C++ supports multiple editors and translators, so you can 
use your Tavurile tools and resource editors as well as 
scripts you've written with In the environment And with 
loci Server, you'll tie able to customize menus and attach 
scripts based on Apple events, AppleScript, and MPW 
Touts Hie built-in SourceSenrer provides a source code 
control system, allowing teams of programmers to solve 
lough problems taste* With SourceServer, you’ll always 
know you're working on Itie latest version And you'll ferve 
Old versions at your fingertips when code "breaks' and 
you need to look back rt irnfifictfoiKS. 5369 

THINK C by Symantec Corporation THINK 0 is easy to 
use and highly visual, making it the No 1 selling 
Macintosh programming environment Enhancements 
make this product taster and more versatile than ever, 
improving your productivity with more powerful project 
management, a full set of loots, and scripi support for 
major script-based languages With the THINK 
environment, you spend less time on routine 
programming tasks due to an extremely fast compiler and 
Incremental linker In addition, the automatic project 
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rrenaget saves you lime by tiackrng changes to your tiles 
and recompiling ooty those that have changes All the 
toots you need - a multi-window editor, compiler, linker, 
debugger, browser. and resource editor m completely 
integrated tor speed and case ot use One of the most 
valuable tri these toots is the THINK Class Library, a set ui 
program building blocks that gives you a head start m 
writing object oriented applications And wilh the new 
open architecture, you can use your favorite tools, 
resource editors, and scupte within the environment 
THINK C is the logical next step for programmers who 
have worked in HypeiCard or other script based 
development environments The environment supports 
AppleScript, Apple events, and Frontier, so you can link 
and automate comptox, mu Hi pmient Operators Product 
Contents Tour Macintosh disks, an 832~page user 
manual and a 568-page THINK Class Library Guide 
$219 

THINK Pascal v. 4.0 by Symantec Corporation 
Professionals and students will welcome this version td 
THINK Pascal It is hilly integrated ter rapid turnaround 
time and lets you take advantage ul System 7 capabilities. 
Features Include support for large projects, enhanced 
THINK Class library, System 7 compatibility, superior 
code generation, and smart linking Product Contents 
Four Macintosh disks, a Seepage user manual, and a 
49B-I»ye objed-otiented programming manual $169 

IS Object Pascal CD nclmtes the world's first 
Object Pascal compiler for Power Macintosh. 100% 
compatible wild Apple's Mm Pascal, IS Object Pascal 
combines dm best i>l Apple's native development tools 
with innovative new technology developed al Language 
Systems Compiler options specify 68K or native 
PowerPC code generation Included on the CD are LS 
Object Pascal compiler, Universal Pascal Toolbox 
interlaces tolly loaded MPW 33 I, 60K and PowerPC 
source debuggers. PowerPC assembler, online 
documcniaiion, Macintosh Tech Notes, and a special 
version ot App Maker by Bnwers Oevelupmeril that 
generatRS native Pascal source code I tie beta release 
Includes upgrades to vt 0 when il becomes available 
$399 

LPA MacProlog comprises a Frilnhurgh syntax 
Prolog compiler system snt in an ahroctrvE mutti-window 
development environment with an integrated program 
editor, graphical call-graph facilities and an interactive 
source-level debugger. LPA MacProlog features high- 
level access to die Macintosh TooEBox lor using graphics, 
dialogs, windows, icons, resources in a simple and 
versatile way LPA MacProlog also includes interfaces to C 
and Pascal code resources The MacPfotop Run time 
Generator enables the production ot tfonhte clickable 
distributable applications The compad rurHime system 
supports fits! argument indexing. Ian-recursion and test- 
call oplimwdmn Optional add ons tools include Ite* 
Prolog^, %/MM tor Oracle and the MacProlog Dialog 
Editor Prugiiirumef Edition $/4h Developer Edition 
(which includes the run-time generator and distnMion 
license) 1150 9 

SmalltafkAgents a 

superset ui Die Smalltalk 
language, is tolly 
integrated wilh Macintosh, 
incor-poratmg design 
features specially tot Ihe RISC and Macintosh System 7 
archiieciure SmalllalkAgcnts is a true object oriented 



workbench lhal includes an incremental and extensible 
compiler, an array of design and cross reference tools, 
preemptive interrupt driven threads and events, an 
extensive class library including classes for general 
programming. classes tor the Macintosh user interlace 
and classes tor the Macintosh operating system 
Integration of components in enterprise systems Is 
Simplified with the network, telecommunication, and inter 
application communication libraries The SiratttalkAgcnts 
extensive class library and add on components make rt 
especially well suited as a development workbench for 
custom applications m business, education, science, 
engineering, and academic research $695 


SOFTWARE FM.INH-HIMf 


MacDesigner/Expert ny Excel Software supports 
soli ware engineering methods with Ihe capabilities of 
MacDesigner plus mu Eli-task design An integrated 
requirement database provides baceability from requirement 
slatomenis to design diagrams, code or test procedures 
This lool is well suited to design or maintenance of real 
time, multitasking software projects Demo $79, Product 
tm MacDesigner' *no$79, Product $995 

MacASD iy I - el Software udmbirws ite? capabilities ul 
MacAnatysbT upei and ManDesigrkar/txperl into a single 
application it supports structured analysis and design, 
object oriented analysis and design, real-tune exfenstocs. 
task design, date modeling, screen prototyping, code edtfing 
and browsing, menybuising, faqutramenl toceaNily, and a 
global data riidinnary Demo $149, Product $2995 

Mac Analyst/Expert, Demo $79 Product $1595 

MacAnalyst Demo $79. Product $995 MacDesigner/ 
Expert, Demo $79 Produci $15$ MacDesigiter 

Demo $79 Product $995 By Excel Software Available Call 
tor more information about Ihese products 

Voodoo is a version control tool tor toe simple amt 
clear management ot protects in which files are created in 
numerous versions (variants and revisions), Voodoo 
allows both variant and revision eaihal, and it manages 
no) only variants and revisions of single files, bul of a 
whole software prajecl (mutti files, multi users, mulU 
variants, access rights, ..). Ihe too! oilers a neat 
graphical user interlace and is not only suliable fur mere 
source node control but can handle all different kinds ol 
fifes with amazing cumpotssiofi rales typical size ol delta 
between aibilrary Hies b% (in words: five per cent) Ml 1 oo 
matter whether Ihe fries are plain lex! or any other 
documents - e g., MSWurd, 4D, Canvas, FileMaker 

VOODOO ^ase nole spec,ai pffces f0 * 

vooDpo uopm single license $190: 2 pack 
V S30LJ. 5 pack $665 IQ pack $1 MO. 20 

~ fTSk pack $2000 Add! pricing available on 
request 


PROFILERS OKBI tpCtFRS 


U Profiler by Lars JurMo Daiakonsult supports 
profiling ot C++ 68K ant! PowerPC applications compiled 
wilh CodeWamoi 6 Cfronl or Symantec Cm Based on 
Mm prolilmg, i.e profiling code called al function enter 
and exit. itie browser aptf icataju fete you teflon call chain 
timings m hierarchical views ur separate windows 
Colled organize, compart and save prolong data from 
diiterenl versions ul your application into a project 
Scriptabte and recordable with lull access to most internal 


data structures Optional remote profiling and tracking ot 
segment and steel usage Full source code 1o what you 
link into your application $295 

Last Resort Programmer's Edition records 
every keystroke, command key and mouse event (in local 
coordinates} to a life on your hard disk. This is especially 
useful tor program testing & debugging, and tor technical 
support and help desks II something goes wrong 
(because of a [xiwtti failure, system crash, turgellmg to 
save or deleting lines) amt you I use a word, phrase, or 
document you can look in the Last Resort keystroke life 
and recover wtral you typed. Last Hesort rs also useful for 
technical support personnel, when they have to ask HVbai 
was Ihe las! thing you did before. T $74,95 

The Memory Mine™ by Adianla is a stand atone 
debugging tool for Macintosh and native PowerPC 
Programmers can monitor heaps, identify problems such 
as memory leaks, and stress test applications Active 
status of memory m a heap is sampled on the fly: 
allocation in non-relocafable (Ptr|. relocatable (Handle) 
and free space is shown, as are heap corruption, 
tragrrentatron, and more.. Allocate, Purge, Compact and 
Zap memory tet users stress test all or part of a program 
Source code is not needed to view heaps it works on 
Macintoshes with 68020 e* later and System 7 0 or Eater 
$99 

QC by Onyx Technology, is a system extension that 
stress fists code during runtime tor common and nof-so- 
common errors Tests Include heap checks, purges, 
scrambles, hantilo/pointer validation, dispose/release 
checks, write to zero, de reference zero as well as olher 
tests like tree memory Invalidation and block bounds 
checking QC is extremely user friendly lor Ihe non¬ 
technical tester yet otters an API (or programmers who 
want precise control over tcsling QC is Also available in 
Japanese $99 95 

Spyer by InCtder is a simple operated tool that records 
al l actions (including mouse movement) you pa form on a 
Macintosh computer and (hen replays them at your 
preferred speed Ihe recorded data can be saved in lites 
for future use Spyer works as a background process with 
any Macintosh application and is triggered by user 
defined Hot Keys. Spyer enables the "Continuous Redo' 
utility and is especially useful lor software leslmg and 
demonstration. $39 


INSTALLER TOOLS 


InstallerPack" hy StepUp Software is a package ol 
several Installer ‘atoms 4 that tef developers incorporate 
graphics, sounds, file compression and custom lolder 
toons into installation scripts Compression E or mate 
supported are Compact Pm & Diamond bach atom also 
available separately Compression requires additional 
licensing $219 

ScriptGen Pro" by StepUp Software is an Installer 
script generator which requires no programming or 
knowledge of to Supports StepUp's InsialJefFacfc. Stuflti 
compression custom packages, splash screens, network 
installs, Rt/ code output. importing resources, and 
AppletvenMmkw/MPW $169 


1JBRAK1LS 


3D Game Machine vl.2 by Virtually Unlimited 


Want more product info? Call us at 805/494-9797. 
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is a C library lor creating lightning fast 3D arcade games 
and interactive mullfmfldia applications 3DGM has a 
simple easy-to-use interface and lea to res very last 
rendering (15 Irames per second on a 1 4" monitor 
completely texture-mapped, with a PowerMac 6100/60), 
full 'virtuaJ‘ 3D worlds with sin degrees of freedom, tree- 
form texture mapping, shading, material and light 
properties, con vex/cave polygons with unlimited vertices, 
unlimited light sources, dynamic hidden surface removal, 
special graphic modes lot fast lull-screen animation, 
collision detection, explosion simulation. 30 data 
importing. Huns an all Macs* Works with CodeWa/oar 
$299 i license 

Animation Class library version 2.0 (ACL? 0) 
is an advanced object-oriented multimedia framework, 
allowing last development of high-quality interactive 
applications. Main features ol ACL? 0 are Howerlul 
animation engine which supports structured sprites, 
collision detection at pixel precision, sprites sorting, 
powerful blitter and vector objeels Scrolling ol 
background picture in circular bullet and Wit- 
mapscrolhng Application framework for building 
standard and 3D controls* panes,menus, luil screen 
displays, windows, elc. Quicklime and multi channel 
sound support >800 functions and >1003)00 lines 
Complete C++ source code for CodeWarrinr and 
Symanlec C++, examples, documentation and technical 
support. $250 

dtF is a true relational database system lor Apple 
Macintosh computers dir prowdes a powerlul choice lor 
developers who warn ro create database centered 
applications with no performance trade offs tftF features 
SOL, full transaction control, error recovery, single user, 
client server architecture and multi platform support 
incJuding DOS. Windows, OS/2 and UNIX, the C/C++ API 
is identical and fully portable cross all supported 
platforms Third-party vendors supporting dlF will be able 
to offer a variety ol advanced features and benefits to their 
customers royally free Toots are included tor importing, 
exporting, creating and managing databases and users 
Supported development environments include: Symantec. 
MPW, Meiiowarkfiand mm. Mac/SDK $b95 

MacWireFrame by Amplified 
intelligence. Create your own virtual reality 
application wilh MacWireFrame, a virtual 
in.ihly application frame work Includes a 
complete library ol object oriented graphics routines, Its 
own easy to understand application frame work (similar to 
MacApp nr TCL but a lot easier to understand), plus an 
example application program that lets you steri solid 
modeling Tight away Comes complete with lully 
documented source code. An new purchases wiil be 
guaranteed a $49 99 upgrade in the soon to be released, 
scriplahie, MacWireFrame 5.0. Due to the overwhelming 
response the special price otter has been extended lot a 
little while lunger Special Offer: S75HI1 

PictureCDEF 1.3 by Paradigm 
Software is a proteional-level CDFF 
for creating custom graplircaJ buttons 
(8-64 pixels). PidumCDFF is used in products by Adobe, 
ProVue STF Technologies and others ll is mu Hi-monitor 
and bit-depth sensitive. Ttie button graphic {cm. ftesEdil) 
can be (Ranged at runtime and ever} animated with a rail- 
back routine. Create distinct buttons in seven variations 
MulhSlale, PushBulton, FfexiButton, ToggleBultori, 
ChkButlDn. PushPicIButton and ToggloPidBulton Position 
the optional butlon itiiu at left txrttnm nr right, or follow the 
system text direction tor International support Manual, 



sample aide and MacApp 30 support Included Full source 
code $95 00 Object code $45 00 

Q3S/3dFane/$martPane source code bundle by 
Vivistar Consulting Q3S source code bundle from 
ViviSlar Consulting. Full featured 3d graphics Points: 
lines, polygons; polyhedra; Gouraud shading; ? buffering, 
culling; depth cueing parallel, perspective, and 
stereoscopic projections, performance enhancing 
"OnlyQD' and ’Wirelramtf modes lull clipping, pipeline 
access; animation and model interaction support, and a 
hr lad mouse" lo map 2d mouse movement to 3d 
3d Pane provides i ntegration wilh the TCt and pr ovides 
a view orientation controller SmartPane provides TCI 
oHscreen image buffering, flicker free animation, and 
QuickTime movie recording SmartPane functions in 3d 
or ?d scenarios AIJ work wilh C++ compilers or ThinkC 6 
and compile to PowerPC or 68K target machines. $192 

SpelIswelI 7 1.0.4 is an award-winning, 
comprehensive, practical spelling checker that works in 
batch mode or within applications Thai incorporate the 
Apple Events Word Services protocol (e g, Etodora 
WordPerfect. Communicate!, and Fair Witness), 
Speilswell ? checks fui spelling errors as well as common 
typos like capitalization errors, spaces hnfnrti punctuation, 
double double word errors, abbrevialinn errors, mixed 
case errors, extra spaces between words, a/an before 
vowcl/consonanl. etc... MacTetil orders inrJudfi developer 
kit with Writeswell Jr a sample Apple Fvents Word 
Services word-processor and its source code $74 95 

StoneTable Extra: Additional functions lor 
SlorteTable Drag seleded cells Within iabse or to other 
tables: optionally add rows as part of drag, popup menus 
or check boxes in cells, variable width grid flues: 
move/dsatj/resrze table in window, clipboard operations 
on multiple celts. Requires StoncTablc (all prices per 
developer) $50 lirst compiler additional compilers $25 

StoneTable; A library replacing all (unctions found in 
hsl manager plus variable size columns/rows; different 
lord, size, style, forecotor, backcolor per cell sort, resize 
move, copy, hide coiumns/rows: edit ceils/tilles In place, 
lilies toi cnliimns/rows, multiple lines per cell, grid line 
patter n/cotor; greater than 32k data per table up to 32k 
text per cell, support for balloon help and binary cell data. 
Versions lor Think C, Think Pascal, MPW C. MPW 
Pascal, Code Warrior 6 C. (all prices per develops) $150 
first compiler, additional compilers $5Q, 

StoneTable and StaneTableExtra for 
PowerPC: Same functionality as 60K libraries 
Versions lor MPW C and CodeWarriof 6 G, Musi haw 
68K libraries, (all prices per developer) Slonetabtn $100, 
SloneTableFxlra $25 


[Wffl 8-Tree HELPER' 2.2 is an inexpensive 
database engine tor Macintosh programmers in 
C source code EMree HtlPFR gels space in a file in 
contiguous fixed length blacks ft expands the life as 
necessary and contracts tiles when possible 8-Tree 
HELPER inserts and deletes keys in one or more B Trees 
ll finds keys equal to. less Ilian, or greater than a given 
value in a few hundredths ol a second, it Hnds lists of 
records whose keys are equal to, less Ihan, or greater than 
a given value or m in a range oi values $150 


SCHlPllNG / SYSTEM ADMINISTRATION 


DalaScfipt DalaSDript is probably tie quickest, easiest 
and most cost effective way to make your integrated 


Want more product info? E-mail us at prQductinfo@xplain.com 
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AppleScript solutions database aware-today Quickest: 
11 takes lust six lines of AppleScript to make new or 
existing scr ipted solutions database aware, and letch data 
bom RDBM's such as Oracle, Sybase. DB2, or Informix, 
Easiest: OataScnpts scripting terminology is easy Id 
learn, easy to use, and easy to remember rtnside 
UidaSeripr contains kits of easy to follow scripts to reuse 
m your own solution. Cost Effective: Because 
DataScript is so easy to learn, and use you'd become 
prududive very quickly, and once you're ready lo ship, 
you'll find our licensing schemes very affracllve. 
$249.00 

Climate by Orchard Software is a command line 
inter lace that lets you communicate with your Mac in lush 
using English commands to create, delete, rename, and 
move files and folders. It can start applications, format 
disks, restart your computer, etc. Climate supplements 
the Finder ft Includes a BASIC interpreter that lels yuu 
scrip! your Macintosh without AppleScript. The interpreter 
includes advanced programming constructs; repeal loops, 
if/lhen/efse conditionals, subroutine calls, etc CLfmate 
implements wildcard characters, enabling you to work on 
groups of files Use CLlmate instead of MPW to manage 
your projects CLfmate is an application occupying 7DK 
disk space if comes bundled with sample programs and 
lull documentation $5995 

Gron Manager by Orchard Software implements Hie 
UNIX Cron facility. It can open any Macintosh file on a 
given dale and lime By creating an alias, renaming it to 
the dale and lime lo open, and moving iUnto the special 
Cron Events Folder, Cron Manager wilt open it Cron 
Manager is a control parrel that creates the special Cron 
f vents Toltfer inside your System Folder It is completely 
transparent lo the user II works like the Startup Items 
Inkier, only smarter It works with any Macintosh fife: it 
you can rioubte-cliek lo start it. Cron Manager can open 
it. $26,95 Cron Manager bundled with CLIrnate, $59,95 

FaceSpan' v2 IS an extensible Rapid Application 
Designer (RADI that makes building applications quick 
and easy ll combines an interactive, visual interface 
design environment with Hie object-oriented power ol 
AppleScript or any OS A language. Best nf all, FaccSpan 
allows you in integrate lire capability ol snrfptable 
programs into your custom application. Yuur FaceSpan 
applications can include any number of windows, dialogs, 
palflttes, and menus. In them, you can display scrolling 
lists, popup menus, scrolling text, movies, multi-column 
tables, pictures, icons, buttons, and others. While no 
scripting is needed for standard behaviors, every item 
may liave ils own script You can even program custom 
objects using Pascal or C Try the perfect choice for MIS 
professionals, power users, consultants, and 
programmers 0 FaceSpan! Includes a royalty-lree 
distribution license, lor unlimited runtime users, ol your 
LaccSpan-based applications. Also included is a TREE 
(JPGRADF lo Ihe next version lor registered users $199 

Rosanne™* Rasarme is a collodion of utilities which 
oiler Ihe user complete control over raw data Users can 
sort tiles, extract selected records, summarize frequency 
counts, create sample hies perform matching on multiple 
files, and reformat date to new specifications, all on the 
desktop, and even on tiles ol a million records or more 
The Rosanne Utilities also support AppleScript 1 * 
enabling the user to link several actions Together to 
complete an entire process. The Hosanna Utilities am 
recordable, users may perform a senes ot actions, and 
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using an AppteStrrpt editor such as Scripter™, see then 
actions transiatcd directly into AppleScript commands. All 
of the utilities support multi-tasking and background 
processing The Rosanne Utilities will assist you in 
picking your specifications, determining record length, 
creating output files and managing the storage ot data 
Rosanna Uttlilies: Copy - duplicates an input file 
Format creates an altered version ol an input fife, 
containing either subsets of the fields on the input file, or 
new fields Select creates a subset of the records on an 
Input tile based on some selection criteria The Recode 
option allows Ihe user to group data, or correct coding 
entries Sort orders an input file by a particular field or 
set ol Helds Match - joins together two Input files based 
on common values occurring in corresponding fields or 
sets of fields Aggregate creates an output file with 
summary levels $595 

ScriptBase™ The Scripting Database Is a 

database lor storing persistent objects to be made 
available lor access 1o AppleScript. Apple's system level 
user scripting language for controlling applications on 
Macintosh* computers Once installed, ihe database 
becomes part ot the AppleScript system, adding a host ol 
commands lo the basic AppleScript vocabulary 
Retrieving Ihe objects is Simple using AppIsScnpl's 
natural-language syntax and sbuctum Objects stored and 
retrieved in ScriptBase can be accessible any time from 
any script on the users computer these objects can be of 
any type, including numbers, character strings, lists, 
records, scripts, and (defences lo disks, lites, folders, as 
well as abstract raw data, to name |ust a few, ScriptBase 
can be used to maintain system-wide sellings, such as 
sets ol preferences, paths in frequently-used files or 
folders Complex installations can be made easier by 
organising data and scripts within the database's 
structure $79 

Script Debugger by Late Might Software Lid is a 
powerful and flexible AppleScript authoring tool. Script 
Debugger makes it simple for novice and experienced 
script writers 1c get the most irom AppleScript, The 
program s advanced debugging environment offers 
single-step script execution with breakpoints The 
Script Debugger dictionary browser features a graphical 
view of objects provided by scriplabfe applications 
With the program, you also receive the late Night 
Sohwam Set [pH rig Additions, a collection of mom than 
70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at p re-do to rmined 
times $129 

Scrip ter* The Author mg and Development 
Environment lor AppleScript 1,1 Scriptcr, Ihe Script 
Coftsiruchofi Set, is the foremost, comprehensive tool for 
creating and debugging AppleScript scripts Schpter is a 
shortcut to ApptescnpTs full capabilities, is both powerful 
and easy lo use. and appeals equally to novices and 
experts Scripts otters he taigest cot tecta of toots to 
answer the needs ol every AppleScript user, eomarning 
over 35 features, including Superior vocabulary 
access point an d-d itk assembly ol commands and 
object specifications; command window for 
experimenter Shortcuts and extended editing 
capabilities extensive drag-amt-ditip. six-function 
tintf-aml-replactr: navigation markers, script library 
collection facility; many otoer ttmesavers lor tester 
scripting interactive debugging - comprehensive 
variable watcher, expression evaluation, enhanced trace 


log. and real single stop debugging! Other features 
include integration with FaceSpan and background 
processing Unlike other scripting loots, which am cither 
based on the original Script Editor concept, or are 
designed io look more like traditional programming toots, 
the designers o* Soipter understood from me outset that 
scripting is different from writing C code Scripter wifi 
change the way you work with AppteScnpt Main Event 
was Ihe firs! to demonstrate AppleScript toots, including 
debugging, and is in use by individuals and corporate 
users From expert scrip! design to user-friendly editing 
and implementation, Scripter is the natural companion to 
AjjpieScript tor all levels ol proficiency $t09 

TCP/IP Scripting Addition 4 is the latest version of 
an award-winning AppteScrfpl scripting addition (first 
place in the 1994 ‘'Best Hack" category in the Everyday 
AppleScript* Programming Competition) This scripting 
addition (or osax) allows you to write scripts using 
MacTCP* commands in AppleScript* Potential uses ot 
this include sending e-mail nr files through a script, 
checking it users are logged on (via Finger), automating 
FTP. Gopher. NetNews, Telnet, and LPR, verifying links m 
I fTMt ttoasnenis. and quickly wi ilmg many other TCP/IP 
client-server programs Sample scripts ate included 
already implementing many of these functions, When 
combined with FaceSpan, the potential lor rapid 
implementation of Internet cM-sera applications is 
enormous the TCP/IP Scripting Addition works with 
AppleScript 10 or later and MarJCP 2 0.4 or later tt is 
compatible with Open Transport* The TCP/IP Scripting 
Addition can be used from Script Editor, HyperCard 2Z 
Mac PERL. FaceSpan and other Open Scripting 
Architecture applications 

Sec "http Jfmm mangntrea aim/bizAiianga/index.htmt* 
tor mare details $49 


MISCELLANEOUS 


pnWfi AppMaker makes it faster and easier to 
Uiill develop the user interface tor a Macintosh 
application just point and click lo design your 
application, then AppMaker creates resources and 
generates excellent source code AppMaker supports 
most development environments including Mctrowcrks. 
Symantec, or MPW, C. C+4, or Pascal, pfocmdural or 
object-oriented, using PowerPianl. TCI. or MacApp The 
generated code uses the Universal Headers to provide 
PowerMac compatibility. Beginners use AppMaker to 
learn object-oriented and Macintosh Toolbox 
programming techniques. Experts use It to increase 
productivity, II saves so much lime it’s like having your 
own assistant programmer working for you Includes one 
year subscription on CD $299 

BASIC for the Newton is 

BASIC for the Newton! From NS BASiC 
Corporation, if is a lutly interactive 
imptemernatioo of the BASIC programming 
language H runs entirety on Bie Newton - no 
host is required it indudes a lull set of functions and date 
types, hand-written mpul windows, buttons and tutensions to 
take advantage of Ihe Newton environment Applications can 
cre^e Cites m access the built-in soups Applications ran also 
access ihe serial port tor input and output. Work directly on 
the Newton, or through a connected Mac/PC and keyboard 
NSBASCindodesalSOpagnfx^ $99 



JJ* * * t * Geekware by Metrowerks is here* 
'g*t*m*r |n high school, they called you a 
computer geek Now. they work at 
burger joints and wear polyester uniforms And you donl 
Wear if to your favorite burger joint $24 95 

Black Sweafishirts $2995 

Mousepad .. $BJ5 

Geekware Sh+rt-Cotton $24.95 

Gcokwarc Shirt-Poly .*., $24.96 

Baseball Cap . $16.95 

Inside CodeWamor 6 Book... $34.95 

Blood, Sweat A Code Alack Long Sleeve Shirt $14&5 
Cross Platform While Short Sleeve Shirt .. $14.95 

Arnold Black l ong Sleeve Shirt. $14 95 



Guide Composer" tves anyone the ability lo create 
powerful Apple Guide help systems tor any new or 
existing Macintosh application Great tor commercial 
developers, shareware developers, in-house developers, 
and consultants, Guide Composer provides a WYSIWYG 
development environment Guide content is developed in 
Guide windows Design topics, phrases, and panels In 
the same format as the user will use them Features are 
WYSIWYG interface, Topics, phrases, and hierarchical 
phrases. Coach marks, Fully-integrated with Apple's 
Guide Maker (distributed with Guide Composer), compiles 
scripts automatically. PiCTs In Panels, Generated Guide 
scripts are modifiable. Compiled fifes are tOQ% Apple 
Guide compatible am! royaliy-free Easy-to-use $99 

MachTen UNIX lor Macintosh and Power Macintosh 
Mantuan is a Berkeley UNIX ibat runs on the Classc to 
the Power Mac including PnwerBooks and Duos 1 So, in 
addition to all ot the Macintosh applications, you gel a 
Mach-based UNIX with pre-emptive multitasking. 
MachTen extends ihe Macintosh operating system with 
UNIX networking and soil ware development tools The 
Maetofosh/UNIX integration is so strong that you can 
even use Macintosh programs and ulililies on UNIX data, 
and UNIX programs and utilities on Macintosh files Full 
internet protocol support ensures fast, easy client and 
server NFS. e-mail, and file transfer between the 
Macintosh and all TCP based entities on your network 
Built-in internet semces include domain name service. 
POP mail service imcioct routing. SUP & PPP. and Web 
sewe Full X11R5 support with Motif for developing X 
applications and a high performance X server for using 
your Mac as an X terminal MachTen - Power UNIX 
$695 Personal MachTen (fat 6BK Macs) $495 
Professional MachTen (lor 6BK Macs) $695 MatfiTan X 
Window Soltware $350 4? 


For complete product Info see the MacTech Web" site at ht Ip://www.mactech.com. 
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TIPS & 
TIDBITS 


By Stew Sisak Contributing Editor 




One feature of MacsBug that I tike is the "swap* 
command, which lets you leave a second monitor display 
the debugger (and punches ii out of the desktop). 

Then, it each DdmgStiO ends in *;g" you will get 
an onscreen log of the last 10 or 15 breaks. I used this to 
track an elusive bug that would freeze my Mac anti trash 
Macsbug memory'.. 1 could see which breakpoint went 
last. 

Matt Slot 


Oo Bitten Twice Shy 

HGeiState does not return a valid handle state when you pass it 
an empty handle (one whose master |vointer is NULL). Instead, 
it returns an error axle, so liefore you call HGeiState, tv sure to 
check that the handle isn't empty and execute an alternate code 
path if it is. 

I was bitten by this because \ was using HGvtState to 
determine if a handle was to a resource, and the resource had 
been purged, so UGetStare returned an error code instead of 
the handle flags and I incorrectly thought the handle wasn't to u 
resource. 

This is documented in Inside Macintosh, Memory t p. 1-61, 
but ii Ivars Mime repeating. ReinelxT to check the error values 
returned by toolbox calk 

Eric Schtegei 


Tips & Tidbits continued on page 66 


IM-ORMAM IN THE MENU B.4K 

[ do drivers, and you |usi plain caul set a breakpoint in ADB 
completion routines (freezes the keyboard so MacsBug is 
worthless!). 

So 1 threw one of (he routines hdow into the routine to 
see when a piece of axle gets executed. 

What does it do!' It lights up" a bar (length dependant on 
screen resolution) in the menu bar. So if you DotToggfe<300); 
you get a flashing saliort line in the menu bar, 

tleave this r mi of prat tuition code! Betmrv of using this on 
24 hit color screens. Make sun* that the mine of where wtii not 
came anythin# to In* written into the alpha channel. Your best 
bet is to test with the sawn that s only ti hits detf* sgsf 

void Dot On (long whort) I 
long Mot: 

dot ^ (long • Mi*WOtScrn8*M() ♦ where); 

•dot |- 1: 

t 

void ftoiOff (Ion* where) I 
lotiR Mot; 

do: * (UiPft *) (LliG*tScml<*eO * wh**re); 

•dot fc* 0 j 
t 

void IkjtTofcfle(long *ttt*re} I 
long Mot; 

Ant - (lcm* *)tUOtScniftuycO 4 where): 

Mot *1; 

t 

Dane Tied 



j end ns your tips or uv If install EtvnIkHterlinsforur . 
on machine! On the other hand, tie might Just 
pay you $25 for each Up ite use p or $50 far Tip of the 
Month You can take your award in goods t 
subscriptions or TSS Make sure any code compiles , p 
and send tips (and where to mail war winnings) to 
Out new Tips e-mail address at Ups&mactech.am 
See page ht'ofar our other addn\<ses. 
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Why Hold Your Breath Waiting for a Client/Server Development Tool? 

- Get JAM’ for the Macintosh Today! 

Rnally,..an industrial strength client/server development tool is available for the 
Macintosh! JAM allows you to build client/server applications on the Macintosh and 
deploy them on more than 100 platforms and operating environments including 
Macintosh, OS/2, Motif, Windows, P05, VAX/VMS. and virtually every implementation 
of UNIX. And unlike the competition’s runtime-only Mac ports, JAM for Macintosh 
provides a full application development environment with true Mac look-and-feel. So 
don't hold your breath any longer - get JAM for the Mac - and get the job done! 

JAM gets your Macintosh applications up and running with: 


m MACC 
Road, Runners 



S 

S 

/ 


Native Mode on froth 6frK and 
Power Macintosh 

Graphical Screen Editor 
True Mac Look-and-Feel 

Full Ctofltdcpment Environment 
“ not just Runtime 


Fbrtabillty to OS/2, Motif, 

Windows, and Character mode 

/ Native PE5M5 Support 
/ Automatic SQL Generation 
/ Ftesdbility to Add 36i or 4GL Routines 
/ No Runtime Charges 


Call 1-000-450-3313 

or E-mail: macjam#$acc.com for a free demonstration left. 
For international inquiries call: 

T-212-267-7722 or FAX 1-212-600-67S3 
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1994 S^TWARE 
PRODUCT 
OF THE YEAR 

' W : M 


To order contact Metrowerks: 

voicei (512) 305-0400 faxi;f$12) 305-0440 e-mail: sales@metFOV9erks r eqrn , 

^ JJ^rld Wide We^hitp://www^etr^werfe.ctmr;.: . ; ■ '; 

Metrowetks. the Mctrowerki logo, Pajv&rPtint artelCodoWaftfa.are r^torea^bemfflk 
Ail Other companies and procijjctiate trademarks# their ruftectirc hajfcjfafitJ aie here^ Wcp^ttert. 














